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Summary of Changes 


Release 4, September 1989 


New Programming Support 
The operator will no longer be requested to remove the write-enable ring from 
a RACF-protected tape when a user with only read authority attempts to 
process a tape for input. 


New Device Support 
Support has been added for the Improved Data Recording Capability feature of 
the IBM 3480 Magnetic Tape Subsystem. 


Service Changes 
Minor technical and editorial changes have been made. 


Release 3.0, June 1987 


Enhancements 
Support for the years beyond 1999 has been added to ISO/ANSI/FIPS labels. 


Support has been added for the IBM 3424 Magnetic Tape Unit. (The IBM 3424 
Magnetic Tape Unit is available only in Brazil, S.A.) 


Customization Restructure | 
Most of the text from Chapters 4 and 6, and Appendix D, has been removed and 
placed in Data Facility Product: Customization. 


Release 2.0, June 1986 


Enhancements 
¢ Support for the IBM 3480 Tape Subsystem has been enhanced to include: 


— High speed search on output. 
— Increased performance in processing standard labels. 


¢ Information about an additional function of the WTOR installation exit, the 
conversion to ISO/ANSI/FIPS Version 3 tape labels without operator inter- 
vention, has been added. 


e If your installation has installed Version 1 Release 7 of Resource Access 
Control Facility (RACEF): 


— Tape data sets, as well as volumes, can be protected. 


Summary of Changes IX 


— NL and BLP tape volumes can also be protected, in addition to. as Ales 
SUL, and AUL tape volumes. 8 : 


ae 
BS 
\ 


— Tape data sets beyond the first can also be protected, in addition to the a . 
first data set. 2s 


— Abnormal terminations, in case you define a tape data set or volume to 
RACF more than once, have been eliminated. | 


Release 1.0, April 1985 


New Device Support 
¢« Information to support the 18-track tape feature of the IBM 3480 magnet | 
Tape Subsystem has been added. 


e Information to support the IBM 3430 Magmenle Tape Subsystem has been 
added. | ca 
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Version 2 Publications 
The Preface includes new order numbers for Version 2. 
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Prefac 





This book is intended to help you understand and use MVS/XA Data Facility 
Product processing of magnetic tape labels. It contains general-use program- 
ming interfaces, which allow you to write programs that use the services of 
MVS/XA Data Facility Product. However, this book also provides the following 
type of information, which is explicitly identified where it occurs: 


is Product-Sensitive Programming Interface | 


Installation exits and other product-sensitive interfaces are provided to allow 
the customer installation to perform tasks such as product tailoring, monitoring, 
modification, or diagnosis. They are dependent on the detailed design or 
implementation of the product. Such interfaces should be used only for these 
specialized purposes. Because of their dependencies on detailed design and 
implementation, it is to be expected that programs written to such interfaces 
may need to be changed in order to run with new product releases or versions, 
or as a result of service. 


[| End of Product-Sensitive Programming Interface dd 


Required Product Knowledge 
In order to use this book effectively, you should be familiar with the following 
topics: 
¢ Data management 


e Job control language 


Required Publications 


You should be familiar with the information presented in the following publica- 
tions: 


« MVS/Extended Architecture Data Administration Guide, GC26-4140, 
describes how to manage data that is processed at your installation by pro- 
viding a systematic and effective means of organizing, identifying, storing, 
cataloging, and retrieving data. 


e MVS/Extended Architecture JCL, GC28-1148, contains information necessary 
to code job control language (JCL) statements, job entry subsystem 2 (JES2) 
control statements, and job entry subsystem 3 (JES3) control statements. 


Magnetic Tape Label Standards 


The following documents provide additional information on code and magnetic 
tape labeling standards approved by the International Organization for Stand- 
ardization (ISO) and the American National Standards Institute (ANSI): 


e American National Standard Code for Information Interchange, X3.4-1977. 
This is a revision of the 1968 version of the code, and is given the acronym 
ASCII. 


Preface XI 


« American National Standard Magnetic Tape Labels and File Structure for 
Information Interchange, X3.27-1978 _ 





e Data Processing—/-Bit Coded Character Set for Information Interchange, ISO 
646-1977 | 


¢ Information Processing—Magnetic Tape Labeling and File Structure for Infor- 
mation Interchange, |SO/DIS 1001-1979 


e American National Standard Recorded Magnetic Tape for information Inter- 
change, 800cpi, NRZI, X3.22-1973 


« American National Standard Recorded Magnetic Tape for Information Inter- 
change, 1600cpi, PE, X3.39-1973 


¢ American National Standard Recorded Magnetic Tape for information Inter- 
change, 6250cpi Group-Coded Recording, X3.54-1976 


¢« Information Processing—9-Track, 12.7mm (0.5in) Wide Magnetic Tape for 
Information Interchange, 32rpmm (800rpi), |SO 1863 


¢ Information Processing—9-Track, 12.7mm (0.5in) Wide Magnetic Tape for 
Information Interchange, 8 and 32rpmm (200 and 800rpi) NRZI, and 63rpmm 
(1600rpi), Phase Encoded, |SO 1864 


e Information Processing—9-Track, 12.7mm (0.5in) Wide Magnetic Tape for 
Information Interchange, 63rpmm (1600rpi), Phase Encoded, |SO 3788 


Related Publications 


Within the text, references are made to the publications listed in the table aS 
below. a 


Short Title 


(as it appears 
in the text) Publication Title 
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Guide 
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Chapter 1. Introduction to Tape Processing 


Labels are used to identify magnetic tape volumes and the data sets they 
contain. You can process tape volumes with IBM standard labels, International 
Organization for Standardization (ISO) or the equivalent American National 
Standards Institute (ANSI) labels, nonstandard labels, or no labels. Your instal- 
lation can optionally install a bypass for any type of label processing; however, 
the use of labels is recommended as a basis for efficient control of your tape 
volumes. 


IBM standard tape labels consist of volume labels and groups of data set labels. 
The volume label is the first record on the tape; it identifies the volume and its 
owner. The data set label groups precede and follow each data set on the 
volume, and identify and describe the data set. 


* The data set labels that precede the data set are called header labels. 


( | ¢ The data set labels that follow the data set are called trailer labels. They 
; are almost identical to the header labels. 


e The data set label groups can include standard user /abels at your option. 


In general, the formats of ISO and ANSI labels, which are defined by the 
respective organizations, are similar to the formats of IBM standard labels; 
unless otherwise specified, the term “standard label,” as used in this manual, 
refers to IBM, ISO, and ANSI standard labels. However, whereas ISO labelea 

oe tapes are coded in the International Standard Code for Information Interchange 

( | (ISCIl) and ANSI labeled tapes are coded in the equivalent American National 

. Standard Code for Information Interchange (ASCII), IBM labeled tapes are 
coded either in the extended binary-coded-decimal interchange code (EBCDIC) 
or in binary coded decimal (BCD). 


Nonstandard tape labels can have any format and are processed by routines 
you provide. Unlabeled tapes contain only data sets and tapemarks. 


Figure 10n page 2 shows the IBM standard, ISO and ANSI standard, non- 
_ standard, and unlabeled tape layouts for a single data set on a single volume. 
( | Detailed layouts and variations for each type are illustrated and described In 
\ the appropriate sections of this manual. 


Tape volumes with standard tape labels may be defined to resource access 
control facility (RACF) by volume serial under the TAPEVOL class of entities. 
RACF authorization checking will be performed for every standard labeled tape 
if system-wide tape protection has been specified. No protection is specifically 
extended by the system to nonstandard labeled tapes, but the installation- 
written nonstandard tape label routines may provide such protection. 
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Figure 1. Basic Tape Layouts 


Describing the Labels 


In the job control statements, you must provide a data definition (DD) statement 
for each data set to be processed. The LABEL parameter of the DD statement 
is used to describe the data set’s labels. You specify the type of labels by 
coding one of the following subparameters of the LABEL parameter: 


Code Meaning 

SL IBM standard labels. 

AL ISO/ANSI/FIPS labels. 

SUL Both IBM Standard and user header or trailer labels. 
AUL Both ISO/ANSI/FIPS and user header or trailer labels. 
NSL Nonstandard labels. 

NL No labels. 


BLP Bypass label processing (BLP). May be used when a data set having no 
labels is to be written. The data set is treated in the same manner as if 
NL had been specified, except that the system does not check for an 
existing volume label. If your installation does not Support BLP, the data 
set is treated exactly as if NL had been specified. BLP is an option spec- 
ified when you initialize Job Entry Subsystem (JES). 


LTM Bypass a leading tapemark, if encountered, on unlabeled tapes. 


If you do not specify the label type, the operating system assumes that the data 
set has IBM standard labels. 
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Only SL, AL, SUL, and AUL tape volumes may be protected with the RACF. The 
installation may provide support for RACF protection of NSL tapes. When the 
— first data set on the first volume specified in the DD statement is created, the 
( volume may be automatically defined to RACF if PROTECT =YES is coded in the 
DD statement. PROTECT =YES may be specified for SL, AL, SUL, AUL, and 
NSL tape volumes. For NSL tapes, the first data set on the first volume is not a 
criterion for a valid PROTECT specification. 


Note: Beginning with RACF 1.7, a volume whose label specification is NL or 
BLP can be protected; that is, NL and BLP volumes can be protected by RACF 
commands or by specifying PROTECT = YES on the DD statement. 


The data set sequence subparameter of the LABEL parameter specifies the 
data set’s relative position on the tape. If you do not specify the relative posi- 
tion, the operating system assumes that the data set Is first on the reel. 


When INOUT or OUTIN is specified as the processing method in the OPEN 
macro instruction, the LABEL parameter can be used to override this specifica- 

( | tion. If INOUT is specified and you want the data set processed for input only, 
code the subparameter IN in the LABEL parameter. If OUTIN is specified and 
you want the data set processed for output only, code the subparameter OUT in 
the LABEL parameter. INOUT is not supported for ISO and ANSI tapes, but will 
be treated as input if the subparameter IN is used in the LABEL parameter. 


When new data sets are created, the LABEL parameter is used to record an 
expiration date and a security protection status in the label. If not otherwise 
specified, the expiration date is recorded as zeros (allowing the data set to be 
overwritten immediately), and security (password) protection is not provided. 


( Note: Beginning with RACF 1.7, RACF uses this LABEL parameter value to 
: determine security expiration. 


Describing the Data Sets 


Other parameters of the DD statement identify the data set, give volume and 
unit information and volume disposition, and describe the data set’s physical 
attributes. The information contained in the DD statement is read by the oper- 
ating system and stored in a table called the job file control block (JFCB). 


Each data set to be processed must also be represented by a data control block 
(OCB) that is created in storage by the processing program. When completed, 
the DCB contains full descriptive information about the data set, and is the con- 
nection between the data set, the processing program, and the operating 
system. . 


Completing the Data Control Block 


Most of the information recorded in the DCB is obtained from: 


¢ The DCB macro instruction in the processing program. The DCB macro | 
instruction is used to construct a DCB and to provide information about the 
data set. 


e The DD statement in the input stream (recorded in the JFCB). 





e The data set label (if this is an existing data set). 
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The DCB is completed at execution time, when it is opened. Figure 2 illustrates 
the sequence of filling in the DCB information. Steps 3 and 7 are bypassed if 
the tapes have nonstandard labels or no labels. 
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Figure 2. Sources and Sequence for Completing the Data Control Block 


Forward Merge. (Steps 3 and 4): Information from the standard data set label is 
> merged into vacant fields of the job file control block (JFCB). (Any fields that 
were already specified by the DD statement are not changed.) Then, in turn, ed 
information from the JFCB is merged into vacant fields of the DCB. (Any fields 
that were already specified by the DCB: macro instruction are not changed.) 
When the forward merge is completed, your processing program can use the 
_ DCB open exit routine to modify the DCB. For a description of the DCB open 
exit routine, see Data Facility Product: Customization. 


Reverse Merge (Step 6): After the DCB is completed, the merging process is 
reversed. For an input data set, information from the DCB is used to fill in any 
vacant fields of the JFCB. For an output data set, the DCB information over- | 
rides the JFCB information (except the data set organization field), and the Me eh 
updated JFCB provides the information for creating the new labels. 


Cataloged Data Sets | | | 
The operating system hae facilities that automatically ee the following 
information about each of ve data sets: 


* Data set name 
ie Serial numbers of the velune or veriines sntaining the data set 
° Type of device on which the volumes should Pe mounted 
e Data set’s relative position on its first volume. | 
The information is indexed by the data set name and recorded on a direct 


access device in a logical structure called the catalog. You can retrieve a cata- 
loged data set by specifying its name in the DD statement. The system finds 
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the associated information in the catalog, and issues a mount message to the 
operator. | | 


Generation Data Groups 
A cataloged data set that is frequently updated, such as a weekly payroll, can 
be grouped with its earlier generations to form a named generation data group. 
A lower-level index in the catalog structure allows generation and version 
numbers to be included in the data set name. For example, the original gener- 
ation of the data set group A.PAYROLL is named A.PAYROLL.GOOO1VO0. The 
fourth generation of the data set is identified as AAPPAYROLL.GOOO4V00. The 
absolute generation and version numbers are in the form GxxxxVyy, where: 


XXXX 
is a decimal number (0001 to 9999) showing the relationship to the original 
generation. The maximum number of generations that can be cataloged is 
established when the index is built for the particular generation data group. 


en yy 
( is a decimal number (00 to 99) identifying a version of the same generation. 


Only the latest version is cataloged. 


You usually refer to a generation data set by specifying its relative generation 
number. For example, A.PAYROLL(O) refers to the latest cataloged generation; 
A.PAYROLL(-1) refers to the next-to-the-latest generation; and A.PAYROLL( + 1) 
refers to a new generation to be added to the group. 


When a generation data group index is established, a related model data set 
co label must be built on the volume that contains the index. This model label 
( may be used to supply uniform attributes for each generation. If you use a rela- 
aa tive generation number to specify a new data set, attributes are taken from the 
model label. You can override the model label attributes with the DCB param- 
eter of the DD statement. 


Information on creating and retrieving generation data groups can be found in 
Data Facility Product: Customization, JCL User's Guide, and Utilities. 


Concatenated Data Sets 
( Through the technique of concatenation, several different data sets, each of 
which may reside on a separate volume, can be read as if they were a single 
data set. 


Concatenated data sets are read in the order of appearance of their DD state- 
ments in the input stream (the DD statements must follow one another and only 
the first DD statement is named). Each concatenated data set may be a single- 
or multivolume data set. Concatenated data sets cannot be read backward. 


Because only one DCB is associated with all the concatenated data sets, you 
must inform data management if the data sets have unlike characteristics 
(device type, block length, record format, and so forth). To do this, your proc- 
essing program must set a switch in the DCB, as explained in Data Adminis- 
tration Guide. | | 
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Passed Data Sets 


Multiple Volumes 


When a data set is used by two or more job steps in the same job, you can 
pass the data set from job step to job step. In this way, you can conveniently 
refer to the data set in the DD statements for each of the later steps, which are 
called receiving steps. Device type, volume serial numbers, data set sequence 
number, and label type need not be coded in the DD statements for the 
receiving steps, because this information is obtained from the passing step. 
However, the data set attributes (density, record format, and so forth) are not 
automatically passed to the DD statements in the receiving steps. If the data 
set has standard labels, the receiving steps can obtain the attributes from the 
labels. If the data set does not have standard labels and the processing 
program does not define the data set attributes, then the DD statements in the 
receiving steps should restate the attributes. 


and Multiple Data Sets 

You can place a single data set on multiple volumes by coding multiple volume 
serial numbers in the related DD statement, or by requesting a nonspecific 
volume. If you request specific volumes and cataloging, all the specified 
volume serial numbers will be associated with the new data set in the catalog. 
lf you use fewer volumes than you specify, you will not be able to retrieve the 
data set properly through use of the catalog. | 


You can place multiple data sets on a single volume by coding the same 
volume serial number on each of the related DD statements, or by using the 
VOLUME =REF parameter on the DD statements for the second and subsequent 
data sets. (VOLUME =REF =*.ddname must not be used if the DD statement 
referred to requests a nonspecific volume.) You must use the LABEL param- 
eter to specify the sequence number of each data set, both when you create it 
and when you retrieve it, except when retrieval is accomplished through the 
catalog. 


You can place multiple data sets on multiple volumes by coding a set of volume 
serial numbers on each of the related DD statements, or you can use the 
VOLUME=REF parameter. (VOLUME=REF must not be used if the data set 
referred to actually used fewer volumes than you specified. 
VOLUME =REF =*.ddname must not be used if the DD statement referred to 
requests a nonspecific volume.) If you code a set of volume serial numbers for 
each of the data sets, the first number must be the serial number of the last 
volume occupied by the preceding data set. 


For multiple data sets on multiple volumes, you must use the LABEL parameter 
to specify the sequence number of each data set, both when you create it and 
when you retrieve it, except when retrieval is accomplished through the 
catalog. The sequence number specified for each data set must indicate the 
relative position of the data set on the first volume of the group of multiple 
volumes that it occupies. Data sets are retrieved in an order that differs from 
the order in which they were written. The specified sequence number must 
indicate the relative position of the data set on the first volume that it occupies. 
Therefore, you must not use the catalog to retrieve a data set that is out of 
order. 


All data sets on a RACF-protected volume are protected. Data sets that span 
multiple volumes should have all volumes protected under a single RACF tape 
volume set profile. This will occur automatically as a data set on a 
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RACF-protected volume is extended onto a new volume that is not RACF pro- . 
tected; the new volume will be defined to RACF as part of the same volume set 
as the previous volume. 


Processing Methods and Routines 


The method of processing (INPUT, OUTPUT, RDBACK, INOUT, or OUTIN) is 
specified by an operand of the OPEN macro instruction. If you do not specify 
the method, INPUT is assumed. 


A data set can be processed as either input or output (INPUT or OUTPUT). A 
data set on magnetic tape can also be read backward (RDBACK). If the basic 
sequential access method (BSAM) is used, a data set can also be processed as 
a combination of input and output (INOUT or OUTIN). For INOUT, the data set is 
an input data set first and then, without reopening, an output data set. For 
OUTIN, the data set is an output data set first and then, without reopening, an 
input data set. INOUT is not supported for ISO and ANSI tapes. 


Data Management Routines 
The input/output support routines of data management perform the label proc- 
essing. These routines are open, EOV, and close. 


Opening a Data Set: The open routine is entered when the processing program 
issues an OPEN macro instruction. The open routine completes the specified 
DCB, and prepares and positions the data set for processing. It analyzes input 
header labels (or trailer labels if the tape is read backward), or creates output 
header labels. 


End of Data Set or Volume: The EOV routine is entered when a tapemark is 
read, when the end of reel {reflective strip) is encountered, or when the proc- 
essing program issues a force-end-of-volume (FEOV) macro instruction. If you 
use the execute channel program (EXCP) technique, your processing program 
must issue an EOV macro instruction to give control to the EOV routine after 
your program recognizes a tapemark or end of reel. The EOV routine proc- 
esses trailer labels on the current volume (or header labels if the tape is read 
backward), and determines if additional volumes are needed to continue the 
data set. If another volume is needed, the EOV routine handles the volume 
switching and processes the labels on the new volume. Otherwise, if the 
current volume is the last or only volume needed, EOV gives control to the 
user’s end-of-data routine that is specified in the DCB. 


Closing a Data Set: The close routine is entered when the processing program 
issues a CLOSE macro instruction. If the processing program terminates 
without closing the data set, the operating system calls the close routine, which 
restores the fields of the DCB to the conditions that existed before the data set 
was opened. It also logically disconnects the data set from the processing 
program, and creates output trailer labels, and provides for tape disposition. 
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Checkpoint/Restart 


When a job step is restarted from a checkpoint, the restart routine repositions = 
tape volumes containing data sets that were open at the time the checkpoint ry 
was taken. The restart routine also restores the applicable DCBs to the condi- 

tions that existed when the checkpoint was taken. 


The restart routine can handle tapes with IBM standard labels, nonstandard 
labels, or no labels. 


Note: Tapes with ISO/ANSI/FIPS labels are not supported by 
checkpoint/restart. Any ISCII/ASCII tape that is open during a CHKPT macro 
service will prevent a checkpoint from being taken. 


All DOS tapes having either a leading tapemark and/or embedded checkpoint 
records can be handled by checkpoint/restart, with the exception of DOS 7-track 
tapes written in translate mode that contain embedded checkpoint records. 


Automatic Volume Recognition 
In installations using the automatic volume recognition (AVR) option, the oper- 
ator can premount volumes on any unused drives. The volumes must be 
labeled (standard or nonstandard). The system records the volume and unit 
information, and assigns the drives to later job steps. 


AVR checks the tape label during allocation by the scheduler, and records the 

volume serial number. This action merely determines which volumes are 

mounted on which devices; AVR does not verify or reject the volumes on the 

basis of their serial numbers. AVR is part of the job scheduler (not of data oe RK 
management). 7 


Tape Disposition 
Tape disposition at end of data set or end of volume can be influenced by the 
DISP parameter of the DD statement. This implied disposition can be over- 
ridden by a positioning parameter of the OPEN, FEOV, or CLOSE macro instruc- 
tion. The OPEN macro instruction controls positioning after an end-of-volume 
condition (multivolume data sets) unless overridden by the FEOV macro instruc- 
tion. The CLOSE macro instruction controls positioning at the end of the data 
set. 


The positioning parameters of the OPEN, FEOV, and CLOSE macro instructions 
are: 


LEAVE Position the volume at the logical end of the data set just read or 
written. (If the data set has been read backward, the logical end is the 
physical beginning of the data set.) 


REREAD Position the volume at the logical beginning of the data set just read 
or written. (When the data set exists on more volumes than there are 
units available, the REREAD parameter should not be used with the 
OPEN macro instruction—it may adversely affect the time required to 
mount the tapes.) Reread cannot be specified for FEOV. 


REWIND Rewind the volume to the load point. REWIND cannot be specified for 
OPEN or CLOSE TYPE=T. 
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DISP Perform the disposition processing that was requested. This can be 
= - REWIND, or REWIND and UNLOAD, depending on the volume attri- 
( ; butes. DISP cannot be specified for FEOV. 
The CLOSE macro has an additional operand that allows you to release tape 
data sets and the volumes on which they reside: 


FREE Specifies that the data set associated with this DCB is to be released 
for use by another task and that the device on which the data set Is 
mounted can be freed for allocation to another job. 


If none of the above are specified, DISP is assumed. 


If necessary, the specified volume disposition can be overridden by the system. 
However, you need not be concerned; the system automatically requests the 
mounting and demounting of volumes depending on the availability of devices 
at a particular time. 


Tape Characteristics 


The following paragraphs describe the data recording characteristics of mag- 
netic tape. The discussion includes density, parity, number of tracks, trans- 
lation, conversion, tapemarks, and so forth, as related to the operating system 
and to IBM 3400 series Magnetic Tape Units. The error conditions that can 
result from conflicting tape characteristics are explained in Chapter 6, “Volume 
Label Verification and Volume Label Editor Routines” on page 113. 


( The phrase “IBM 3400 Magnetic Tape Units” refers to the IBM 3410, the IBM 
an | | 3420 Models 3, 4, 5, 6, 7, and 8, the IBM 3422, the IBM 3424’, the IBM 3430 Mag- 
| netic Tape Subsystem, and the IBM 3480 Magnetic Tape Subsystem. 


Nine-Track Tapes 
The operating system supports 9-track tape in densities of 800 bpi (bits per 
inch), 1600 bp!, and 6250 bpi. 


2 Nine-Track Dual-Density Feature 
( The dual-density feature, available on some tape units, permits the unit. to read 
and write in either of two densities. The density combinations available are 
800/1600 bpi and 1600/6250 bpi. You specify the density with the DEN param- 
eter of the DD statement or DCB macro instruction (Figure 3 on page 10 shows 
the DEN parameter codes). If the DEN parameter code is not specified, the 
greater density is assumed. 


The DEN parameter is ignored for input. The system automatically sets the 
tape unit to the density of the tape. | 


For output with dual density, the tape is written in the density you specify or, if 
unspecified, the default density. If your request is for a standard labeled tape, 


and the label of the mounted volume is written in the wrong density, the system 
will rewrite the label to agree with your specification, provided that you are 


| 1 The 3424 Magnetic Tape Unit is available only in Brazil, S.A. 
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Seven-Track Tapes 


opening the first data set on the volume. If this is not the first data set on the 
volume, the system will change your density specification to agree with the 
density of the volume. Tapes created with the dual-density feature and those 
created without it are interchangeable. 


Recording Density 


DEN Value! 7-Track 9-Track 18-Track 
1 556 = N/A 
2 800 800 (NRZT) N/A 
3 _ 1600 (PE) N/A 
4 _ 6250 (GCR) N/A 


NRZI is for Nonreturn-to-zero-inverse mode. 
PE is for Phase encoded mode. 


GCR is for Group coded recording mode. 


1 If the DEN parameter is not supplied by any source, 
the highest applicable density is assumed. 


Figure 3. DEN Parameter Codes for Specifying Tape Density 


The 7-track feature allows a tape unit to read and write 7-track tapes. This 
special feature consists of a 7-track read/write head (instead of a 9-track head) 
and control unit changes, including a translator. Data can be read or written in 
densities of 556 or 800 bpi with either odd or even parity. Nine-track tapes 
cannot be read on tape units with the 7-track feature installed. The translator 
takes 8-bit EBCDIC characters from your buffer and writes them as 6-bit binary 
coded decimal (BCD) tape characters and translates the opposite way during a 
read operation. Density and parity can be set and the translator can be turned 
on and off, by mode setting control commands. When the translator is off, only 
the six low-order bits of the characters in your buffer are written on tape; during 
reading, the two high-order bits are set to zeros. 


ISO and ANSI standards do not include a specification of 7-track magnetic tape 
for information interchange. Therefore, the 7-track feature is not applicable for 
tapes with ISO or ANSI labels. 


The data conversion feature can also be installed with the 7-track feature. The 
data conversion feature makes it possible to write binary data on /-track tape. 
It writes three characters from your buffer as four tape characters, and converts 
the opposite way during reading. Conversion is turned-on and off by mode 
setting control commands and is mutually exclusive with translation. You must 
use the data conversion feature to process format-V (variable-length) tape 
records because the length field of such records contains binary data. You 
cannot use the data conversion feature with the read backward {(RDBACK) proc- 
essing method. 


The operating system supports the various densities of the 7-track feature. You 
specify the density with the DEN parameter of the DD statement or DCB macro 
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instruction (Figure 3 shows the DEN parameter codes). If not specified, the 
default value is 800 bpi. 


If the DEN parameter specifies a density incompatible with the tape unit, the job 
step will be abnormally terminated. 


If you use densities other than 800 bpi for 7-track system input tapes (SYSIN), 
system output tapes (SYSOUT), or tapes to be handled by the AVR option, you 
must establish the particular density for each during the system generation 
process. : 


Mode information other than density is specified with the tape recording tech- 
nique (TRTCH) parameter of the DD statement or DCB macro instruction. 


The codes for the TRTCH parameter are: 


Code Meaning 

T Odd parity with translation 

C Odd parity with conversion 

E Even parity with no translation or conversion 
ET Even parity with translation 

null Odd parity with no translation or conversion 
(entire parameter (same as 9-track) 

is omitted) 


You use the DEN and TRTCH parameters (or their default values) to specify the 
density and mode of the data to be read or written. If the tape contains 
standard labels, the DEN parameter also specifies the density of the labels. 
IBM recommends that all data sets on a tape containing standard labels be 
written in the same density. IBM standard labels on 7-track tape are always 
written in BCD, with the translate bit on, and even parity, regardless of the 
value of the TRTCH parameter. 


Nonstandard labels on 7-track tape can be read or written in any code with any 
parity. The density of the labels need not be the same as the density of the 
data, but the density of associated tapemarks should be carefully planned. 
system recognition of tapemarks is ensured only when they are read in the 
density in which they were written. 


Eighteen-Track Tapes 


The operating system supports the IBM 3480 Magnetic Tape Subsystem, which 

uses 18-track recording. For 3480 tapes, only a single density is available and 

is used by the system for reading and writing; any density with the DEN param- 
eter is ignored. 


The 3480 Magnetic Tape Subsystem with the Improved Data Recording Capa- 
bility can record data in either of two formats: compacted or standard. The 
recording format is specified in the tape recording technique (TRTCH) param- 
eter of the JCL DD statement or the DCB macro instruction. 
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| The codes for the TRTCH parameter are: 


| Code Meaning _ y 
| COMP | Record data in compacted format 

| | | NOCOMP Record data in standard 3480 format 

| null (entire parameter Record data in standard 3480 format? 

—— is omitted) 


ISO and ANSI standards do not include a specification of 18-track magnetic tape 
for information interchange. Therefore, 18-track recording is not applicable for . 
tapes with ISO or ANSI labels. 


Tapemarks 
A data set or label group on tape is usually followed by a tapemark delimiter. 
A tapemark is a special character written by a control command. (In the figures 
of this manual, tapemark is represented as “TM.”) The tape drive recognizes a 
tapemark during a read operation and signals a unit exception condition. The 
condition is displayed by the unit exception bit in the channel status word 
(CSW), where it is recognized by the operating system. The tapemark is not 
read into virtual storage. 


Beginning and End of Tape 
On /-track and 9-track tape units, a reflective strip at the beginning of a tape oe 
indicates when the tape is positioned at its load point; a “load point” indicator 
bit is set in a sense byte, and is recognized by the operating system. A reflec- 
tive strip also marks the logical end of the tape. If a reflective strip is encount- 
ered during a write operation, the hardware signals a unit exception condition 
in the CSW. 


| | In contrast to the above, the IBM 3480 Magnetic Tape Subsystem (with or 
| . without Improved Data Recording Capability) has an internal mechanism that 
| senses the beginning and end of tape. Reflective strips are not used. 


| 2 The default value for the TRTCH parameter can be changed during system installation from standard 3480 
| format (NOCOMP) to compacted format (COMP). | 
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Chapter 2. IBM Standard Labels 


If you specify SL in the LABEL parameter of the DD statement, or if you do not 


specify a label type, the data management routines of the operating system 


perform IBM standard label processing. If you specify SUL, data management 


processes both IBM standard labels and IBM standard user labels. 


This chapter describes the organization, formats, and contents of IBM standard 


labels, and explains how they are processed or created. 


Label Definitions and Organization 


IBM standard labels are 80-character records written in the density specified 


via JCL. Seven-track tape records are recorded in BCD, even parity, translate 


on. The first four characters are always used to identify the labels: 


Label Identifier _ 7 Label Description 

VOL‘ - | Volume label 

HDR1 and HDR2 _ Data set header labels 

EOV1 and EOV2 - Data set trailer labels (end-of-volume) 
EOF1 and EOF2 Data set trailer labels {(end-of-data-set) 


UHL1 through UHL8 User header labels 
UTL1 through UTL8 User trailer labels 


The header and trailer labels use identical formats; therefore, there are only 


four different label formats. These formats are described later in this section. 


The four types are: 
¢ Standard Volume Label (identified as VOL1) 
e Standard Data Set Label 1 (identified as HDR1, EOV1, or EOF1) 
« Standard Data Set Label 2 (identified as HDR2, EOV2, or EOF2) 
e Standard User Label (identified as UHL1-UHL8 or UTL1-UTL8) 


Figure 40n page 14 and Figure 5 on page 15 show the positions of the labels 
with various tape volume organizations. A tape with IBM standard labels must 


contain a volume label and data set labels. User labels are optional. 
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Single Data Set | Single Data Set | -* 
Single Volume Multiple Volumes YY 


Volume Label 


Data Set Header Labels 
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| User Header Labels 
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TM | End cf Data Set 
TM f 
Single Data Set/Single Volume: The volume label is followed by the data set header labels and optional user 
header labels. The data set is preceded and followed by a tapemark. The data set trailer labels are identified as 
EOF and followed oy cotional user trailer labels. Two tapemarks follow the trailer label group to indicate that yer Se 
the data set is the last data set on the volume and is not continued on another volume. ' ° 
a oe 
Single Data Set/Multiple Volumes: More than one volume is needed to contain the data set. The last volume : 





is organized the same as a Single volume. On the cther volumes, the data set trailer labels are identified as EOV 
instead of EOF, and the trailer label group is followed by one tapemark instead of two. The data set and user 
labels are repeated on each volume, and there is a separate volume label for each tape. 


Figure 4. Volume Organizations with IBM Standard Labels (Single Data Set) 
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Multiple Data Sets/Single Volume: The tape begins with a volume label. Each data set is preceded by a header label group 
and a tademark, and is followed by a tapemark and a trailer label group. The data set trailer labels are identified as EOF. 
Each trailer labe! group is followed by a tapemark; the trailer label group fo the last data set on the volume is followed 

by two tapemarks. 








Multiple Data Sets/Multiple Volumes: More than one volume is needed to contain the multiple data set aggregate. The last 
volume is organized the same as a multiple data set/single volume layout. On the other volumes, the last data set trailer 
labels are identified as EOV irstead of EOF, and the last trailer label group is follawed by one tapemark instead of two. 


There is a separate volume label for each tape. 





Figure 5. Volume Organizations with IBM Standard Labels (Multiple Data Sets) 
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Volume Label es | 

The IBM standard volume label (VOL1) appears at the beginning of each tape. ax 
The volume label identifies the volume and Ht owner and is used to verify that ae, 
the correct volume is moun | 7 


~ The volume label is created by either a utility program or the user’s program 
when the tape is first received at an installation. 


Data Set Header Labels 
The data set header label group consists of IBM standard data set label 1 
(HDR1) and IBM standard data set label 2 (HDR2). The HDR1 label contains 
operating system and device-dependent data that relates to the data set. The 
HDR2 label contains additional data set characteristics. These labels are used 
to identify and describe the data set and to protect it from unauthorized use. 


These labels are created automatically by data manasenicnt each time a data 
set is recorded on tape. 


User Header Labels 
Optionally, a maximum of eight user header labels (UHL1 to UHL8) can appear 
on the tape immediately following the data set header labels. These labels 
contain user-specified data that can be made available to your program for 
processing. 


If you want data management to write user header labels or to make user 

header labels available to your program, you must specify SUL on the DD state- os 
ment and specify the address of a user header label routine in the DCB exit list. eZ 
(The exit list can address several user header label routines, that is, routines 

that process input user header labels and create output user header labels.) 

The DCB exit list (EXLST) is described in Data Facility Product: Customization. 


Data Set Trailer Labels 
The data set trailer label group consists a IBM standard data set label 1 (EOV1 
or EOF1) and IBM standard data set label 2 (EOV2 or EOF2). These labels dupli- 
cate the IBM data set header labels so that the tape can be read backward. 
The trailer labels are identical to the header labels, except that: 


¢ The identifier is EOV or EOF instead of HDR. 


e A block count is recorded in the first trailer label (EOV1 or EOF1) and is 
used on input to verify that all blocks of the data set are processed. The 
block count field in the HDR1 label contains zeros (EBCDIC or BCD). 


These labels are created automatically ey data eae when the data set 
is recorded on tape. 


User Trailer Labels 
Optionally, a maximum of eight user trailer labels (UTL1-UTL8) can immediately 
follow the data set trailer labels. These labels contain user-specified data that 
can be made available to your program for processing. — 


If you want data management to write user trailer labels or to make user trailer 
labels available to your program, you must specify SUL on the LABEL param- 
eter of the DD statement and specify the address of a user trailer label routine 
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Additional Labels 


Tapemarks 





in the DCB exit list. (The exit list can address several user trailer label rou- 
tines, that is, routines that process input user trailer labels and-create output 
user trailer labels.) The DCB exit list (EXLST) is described in Data Facility 
Product: Customization. 


The operating system does not support any additional labels in the groups 
described above. This applies to labels identified as VOL2-VOLn, HDR3-HDRn, 
UHLS-UHLn, and so forth. If such labels exist on an input tape, they are 
bypassed. They are omitted on output tapes. 


Each data set and each data set label group to be processed by data manage- 
ment must be followed by a tapemark. 


¢ There is no tapemark between the volume label and the first header label 
group on the volume. _ : 7 


e The tapemark that marks the end of the header sie group also indicates 
the beginning of the data set to be processed. 


e The tapemark that follows the data set also indicates the beginning of the 
trailer label group. 


« A tapemark marks the end of the trailer label group. A second tapemark 
follows the trailer label group of the last data set on the volume, provided 
the data set does not continue on another volume. 


When the operating system is used to create a data set with IBM standard 
labels, data management writes the necessary tapemarks. 


IBM Standard Label Processing 


Label processing is handled by the I/O support routines of data management 
(open, EOV, and close). This processing consists of three basic functions. 


e Checking the labels on input tapes to ensure that the correct volume is 
mounted, and to identify, describe, and protect the data set being processed 


¢ Checking the existing labels on output tapes to ensure that the correct 
volume is mounted, and to prevent overwriting of vital data 


« Creating and writing new labels on output tapes 
These processing functions are summarized in Figure 6 on page 18. The table 
shows the specific labels that are processed for each function and which rou- 


tines perform the functions. The summary in os 6 is the basis for the dis- 
cussions of label processing that follow. 
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Volume Header Labels Trailer Labels 


peta 
Processing Label EOF1 
VOLT HDR1 HDR2 UHLI-8 or | 
| EOV1 


bicep eich at oe Pa, 


First or only 
volume: 












Checks labels Open Open Open Open EOV bypassed 
on input tape. 








Checks existing Open Open not read not read not read not read 
labels on output 
tape before — 
overwriting. 








Writes new Open Open Open Open Close Close 


labels on or user 4 or EOV or EOV 
output tape. | 


Second or 
subsequent 
volumes: 5 





Checks labels EOV 


bypassed EOV EOV bypassed EOV 
on input tape. . 





Checks labels EOV 
on outout 

tape before 
overwriting. 


not read not read not read not read not read 





Writes new EOV 
labels on or user 4 
output tape. 


nm 


Notes: 


EOV EOV Close Close Close 
or EOV or EOV or EOV rae 
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bee 


'For read backward operations, the action on header and trailer labels is reversed. 


2 Includes the first volume of concatenated data sets with unlike characteristics. (Data sets with like characteristics can 
be processed correctly using the same cata control block (DCB), input/output block (IOB), and channel Piogramt Any 
exception in processing makes the data sets unlike.) 


3 |f DISP= MOD is specified on tne DD statement, the open routine positions the tape at the end of the existing data set 
and allows an input user trailer label routine to process user trailer labels (prior to overwriting the existing labels). 





4 User can create the label with the IEHINITT utility program cr a user program. Subsequently, the label may be 
rewritten by the open and EOV routines. 


S Includes the first volume cf concatenated data sets with like characteristics. 


Figure 6. IBM Standard Label Processing by Data Management Routines 


When a data set is opened for input, the volume label and HDR1 are processed. 
HDR2 is processed if it exists. For an input end-of-data condition, the trailer 
labels are processed, unless deferred user input trailer label processing is 
specified in the data control block (DCB) exit list.. For an input end-of-volume 
condition, the trailer labels on the current volume are processed, and then the 
volume label and header labels on the next volume are processed. (When the 
FEOV macro instruction is issued for an input tape, the trailer labels on the 
current volume are not processed, but the volume labels and header labels on 
the next volume are processed.) No label processing is performed when an 
input data set is closed, unless deferred user input trailer label processing is 
specified in the data control block (DCB). If deferred user input trailer label 
processing was specified, the processing otherwise performed for an input end- 
of-data condition is performed when an input data set is closed. 
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When a data set is opened for output, the existing volume label and HDR? label 
are checked, and a new volume label and new header labels are written. For 
an output end-of-volume condition (including FEOV), trailer labels are written on 
the current volume, the existing volume and header labels on the next volume 
are checked, and then a new volume label and new header labels are written 
on the next volume. When an output data set is closed, trailer labels are 
written. 


RACF Protection 


ALTER access authority is required to create or destroy a tape volume label. 
UPDATE access authority is required when opening a RACF-defined tape 
volume for output (including INPUT or OUTIN specification). READ access 
authority is required when opening a RACF-defined tape volume for input. For 
an overview of RACF protection for tape volumes, see RACF General Informa- 
tion Manual. 


Opening an Input Data Set 


If IBM standard labels are specified, the first record on the input tape must be 
an IBM standard volume label (VOL1). At the time the data set is opened, data 
management checks the first record on the tape to determine whether the 
record is 80 bytes long and contains the identifier VOL1 in the first 4 bytes. The 
various error conditions that can occur during verification of the first record are 
explained in Chapter 6, “Volume Label Verification and Volume Label Editor 
Routines” on page 113. 


Volume Serial Number 


Data management uses the VOL1 label to ensure that the correct tape is 
mounted. The volume serial number in the label is compared to the volume 
serial number that you specify. You can specify the serial number either 
directly in the DD statement or indirectly through the catalog facility. Serial 
numbers are required when the processing method is INPUT, INOUT, or 
RDBACK. 


If the volume serial number is correct, data management resets a mount switch 
in the unit control block to indicate that volume mounting is verified (the switch 
is initially set when the mount message is issued to the operator). If the serial 
number is not correct, data management rejects the tape and issues another 
mount message. 


After the volume is mounted and verified and if the system-wide RACF tape pro- 
tection option has been specified, RACF access authorization to the volume is 
checked. READ authorization is checked if open for INPUT or RDBACK. If open 
for INOUT, UPDATE authorization is checked. If the volume is not defined or if 
the user is authorized to the volume, processing continues; otherwise, the 
program is abnormally terminated. 
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Positioning the Volume to the Data Set 


When the volume is mounted and verified, data management positions the tape 
in front of the header label group of the data set to be processed. Usually, 
there is only one data set on the reel, and the header label group immediately 
follows the volume label. 


To retrieve a data set when more than one data set is on a single reel of tape, 
you specify a data set sequence number in the LABEL parameter of the DD 
statement, unless the data set is cataloged. For a cataloged data set, you need 
not specify a data set sequence number, because the number can be obtained 
from the catalog along with the volume serial number. 


e The sequence number can be from 1 to 9999, with 1 representing the first 
data set on the volume. If you specify a sequence number higher than the 
number of data sets on the volume, your task will be abnormally terminated 
or, if the volume ends with EOV labels, the open routine will switch to the 
next volume. 


e If the data set is not cataloged and you do not specify a sequence number, 
or you specify 0, data management assumes that the data set is the first in 
sequence on the volume. 


To position the tape, data management uses the requested data set sequence 
number shown in the JFCB and the data set sequence number shown in the 
first HDR1 label on the tape, and maintains a logical data set sequence number 
in the unit control block (UCB). The number in the UCB represents the current 
position of the tape and is maintained as follows: 


1. When a tape is first mounted, the data set sequence number in the UCB is: 
0. 


2. When a data set is opened, the open routine sets the data set sequence 
number in the UCB to 1. The exceptions are: 


¢ If the tape is still positioned from previous processing, such as for a 
LEAVE request, the open routine does not reset the number in the UCB. 


¢ If the data set sequence number in the JFCB and the data set sequence 
number in the first HOR1 label on the tape are both greater than one, 
the open routine sets the data set sequence number in the UCB to the 
value of the number in the first HDR1 label. (The data set sequence 
number in the first HDR1 label may be greater than one when the 
volume is part of a multiple-data-set/multiple- volume aggregate.) 


¢ When the processing method is INPUT or OUTPUT to the start of a data 
set on a multiple file tape, the open routine starts with the first value, 
unless a volume sequence number is specified. If the volume ends with 
EOV labels before the desired file sequence number, the open routine 
will switch to the next volume and permanently update the volume 
sequence number so that the next open to this data set will start with 
the correct volume. 


¢ When the processing method is RDBACK or OUTPUT DISP=MOD to the 
end of the data set, the open routine speeds up finding the end of the 
data set by starting with the last volume specified, unless a volume 
sequence number its specified. 


Note: The use of the DCB=DSNAME parameter in the JCL causes a 
specific volume sequence number of one. If the data set is not yet 
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present on the last volume specified, the open routine can recover, if 

the file sequence number is 1, by backing up volumes. It detects that 

the data set is not present if the dsname is invalid, the tape starts ata 
file sequence number greater than 1, or the VOL label is followed by a 
tapemark. 


3. The data set sequence number in the UCB is compared to the requested 
data set sequence number in the JFCB. If they are equal, the tape Is 
already positioned at the requested data set. If they are not equal, the 
open routine adjusts the data set sequence number in the UCB as the tape 
is positioned past each data set, until the number in the UCB equals the 
number in the JFCB. 


4. When multiple tape units are used and a volume switch causes processing 
to be continued on a volume on a different unit, the EOV routine copies the 
data set sequence number from the previous UCB to the current UCB. 


5. If the data set is not open or has been closed, the UCBFSCT field of the 
UCB will be set to X’0000’ if: 


« The data set was never opened. 
e CLOSE (,REWIND) was specified. 
e CLOSE (,REREAD) and LABEL=1 was specified. 


e CLOSE (,DISP) was specified or defaulted, and DISP=(,PASS) was not 
specified on the JCL. 


Otherwise, the UCBFSCT field of the UCB will have a value one greater than 
the value specified on the LABEL parameter of the JCL. 


6. If the job terminates abnormally while a tape data set is open, the data set 
will be closed and the tape will be positioned as when CLOSE (,LEAVE) is 
specified. That is, the UCBFSCT field of the UCB will have a value one 
greater than that specified on the LABEL= parameter of the JCL. 


Only one data set on a tape volume may be open at any given time. An 
attempt to begin processing of a second data set on the same volume results in 
abnormal termination. 


When the tape is positioned to the data set header label group of the first data 
set or the requested data set, data management checks the label identification. 
If the identifier HDR1 is not found, processing is abnormally terminated. 


To ensure that the correct data set is being opened, data management com- 
pares the data set name shown in the HDR1 label of the requested data set to 
the data set name specified by the user in the DD statement. This comparison 
is made on only the 17 least significant (rightmost) characters of the data set 
name (including 8 characters for the generation and version numbers if the data 
set is part of a generation data group). 


If the comparison shows an incorrect data set name, processing is abnormally 
terminated. 
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Open/EOV User Exit for Security Verification 


Expiration Date 


For Authorized Program Facility (APF) programs for which the program property 
“bypass password (and RACF) checking” is active, a user exit is provided for 
verifying that a tape selected by open or EOV should be used, and whether 
certain security checks may be bypassed. For more information on the 
“Open/EOV volume security and verification” exit, see Data Facility Product: 
Customization. 


The expiration date shown in the HDR1 label is not verified for input data sets, 
unless the processing method is INOUT. For INOUT, if the expiration date has 
not been reached, data management notifies the operator and asks for confir- 
mation of the use of the tape. If confirmation is not received, processing is 
abnormally terminated. (If you override the INOUT specification by coding 
LABEL =(,,,IN) on the DD statement, the expiration date is not verified.) 


Password Protection 


Block Count 


If the volume is RACF protected and authorization to access the volume was 
checked when the volume was verified, password checking will be bypassed for 
any data set on the volume. Password protection is not recommended for any 
volume data set; RACF protection is preferred. 


The block count shown in the HDR1 label is always 0 (EBCDIC or BCD). This 0 
is recorded in the data control block {in binary) and increased during proc- 
essing for comparison to the block count shown in the trailer label (EOV1 or 
EOF1). 


For reading backward, the block count shown in the trailer label (EOV1 or EOF‘) 
is recorded in the data control block and decreased during processing for com- 


parison to the 0 block count in the HDR1 label. 


The block count is verified at end-of-data or end-of-volume. 


Data Set Characteristics 


The HDR2 label immediately follows the HDR1 label. Data management uses 
the HDR2 label to determine certain data set characteristics, if these character- 
istics are not otherwise specified by the user. The characteristics that can be 
obtained from the HDR2 label are: 


e Record format 
¢ Block length 
e Logical record length 


e Tape recording technique (7-track tape, 3480 Magnetic Tape Subsystem with 
Improved Data Recording Capability) 


e Type of control eharacters 


The above information is obtained from the label and recorded in the job file 
control block (JFCB) and the data control block, provided the appropriate fields 
in these control blocks contain zeros. The label information cannot override 
any characteristics previously specified in the processing program or the DD 
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Statement. This merging process is explained and illustrated in the introduction 
to this manual. 


Unless user header labels are to be processed, data management positions the 
tape past the tapemark immediately after processing the HDR2 label. All labels 
that follow the HDR2 label are bypassed and the tape is positioned at the first 
data set record. 


Note: If the HDR2 label is missing, processing will continue with the assump- 
tion that it is not needed. If the JFCB/DCB merge function needs it because of 
missing data set characteristics, the OPEN will abnormally terminate. 


User Header Labels 


Read Backward 


Up to eight user header labels (UHL1 to UHL8) may follow the HDR2 label. To 
make the user header labels available to your program, SUL must be coded on 
the DD statement and the address of an input user header label routine must 
be specified in the DCB exit list. If you omit one of these parameters, data 
management positions the tape past the tapemark immediately after processing 
the HDR2 label. 


For the read backward (RDBACK) processing method, data management uses 
the data set’s trailer labels as header labels, and vice versa. Each label group 
is read in the normal sequence; that is, EOF1 before EOF2, and so forth. The 
data records, however, are read in reverse sequence. 


Multivolume data sets can be read backward. Concatenated data sets, /-track 
tape with data conversion, and format-V (variable-length) records cannot be 
read backward. 


End-of-Data or End-of-Volume on Input 


Block Count 





Data management’s EOV routine handles both end-of-data-set and end-of- 
volume conditions on input. These conditions occur when: 


e A tapemark its read. 


e An FEOV (force-end-of-volume) macro instruction is executed by the proc- 
essing program. 


After encountering a tapemark, data management checks the first 4 bytes of the 
first trailer label for the identifier EOV1 or EOF1. If neither identifier is found, 
processing is abnormally terminated. When the FEOV macro instruction is exe- 
cuted, the trailer labels are not checked. 


To verify that all records on the input data set on the current volume have been 
read, data management compares the block count shown in the first trailer 
label (EOV1 or EOF1) against the block count that was accumulated in the data 
control block. For reading backward, data management compares the O block 
count shown in the HDR1 label against the block count in the data control block. 


If the block count in the label does not equal the block count in the data control 
block, the EOV routine gives control to the appropriate entry in the user’s DCB 
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exit list. This entry in the exit list is identified as OB (hexadecimal). The EOV 
routine passes the following information to the exit routine: 


Register Contents 
0 The block count shown in the label 
4 The address of the data control block 


After your exit routine analyzes the discrepancy (and possibly prints a 
message), your exit routine must return to the EOV routine with one of the fol- 
lowing return codes in register 19: 


Return 
Code Meaning 


0 Abnormally terminate with completion code 237 (hexadecimal). 


4 Continue processing. 


If you do not provide the appropriate user exit entry in the DCB exit list, a block 
count discrepancy will cause processing to abnormally terminate with a com- 
pletion code of hexadecimal 237. When the FEOV macro instruction is exe- 
cuted, the block count is not verified. 


If the data set was created with a DCB with no device-dependent section, the 
block count is written as zero and is not verified. 


The EOV2/EOF2 Label 
Except when it is used as a header label for a read backward operation, data 
management ignores the second trailer label (EOV2 or EOF2) of an input data 
set. 


User Trailer Labels 
If user trailer labels (UTL1-UTL8) are present on input, data management can 
make them available to your program. To make them available, SUL must be 
coded on the DD statement and the address of an input user trailer label 
routine must be specified in the DCB exit list. 


Determining Volume Switch 
For a multivolume input data set, you must specify the serial numbers of all the 
volumes to be processed. The serial numbers are specified either directly in 
the DD statement or indirectly through the catalog procedure. You specify the 
serial numbers in forward sequence, regardless of whether the tapes are to be 
read forward or backward. 


« For noncataloged data sets, you specify the volume serial numbers in the 
VOLUME parameter of the DD statement. Data management processes the 
group of volumes in whatever order you specify and processes only the 
volumes you specify. 


e For cataloged data sets, the group of volumes must be processed in 
sequential order. However, you can begin processing at any volume of the 
group by specifying a volume sequence number in the VOLUME parameter 
of the DD statement. 
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For input, the label identifier of the trailer labels determines whether data man- 
agement continues processing the data set. When data management finds an 
EOV label, it performs volume switching. When data management finds an EOF 
label, it passes control to the user’s end-of-data routine, with one exception: If 
the DD statement specifies OPTCD=B, and if an additional volume is available, 
data management performs volume switching. If OPTCD=B and no volumes 
are available for switching, data management passes control to the user’s end- 
of-data routine. 





To determine whether additional volumes are required, data management 
maintains a volume sequence number in the data extent block (DEB) in storage. 


« For read forward operations, the volume Sequence number in the DEB is 
increased as each volume is processed. This count is compared to the 
total number of volumes requested, as shown in the JFCB. 


e For read backward operations, the volume sequence number in the DEB Is 
; initialized to the total number of volumes requested, as shown in the JFCB. 
( : The DEB count is decreased as each volume is processed until the count 
reaches 0. 


If another volume is not required (end-of-data-set condition), control is given to 
the user’s end-of-data routine that is specified in the data control block. Subse- 
quently, the processing program or the operating system closes the data set. 


e The user’s end-of-data routine is not entered until the last specified volume 
or the last concatenated data set is processed. 


a ¢ If an input data set is closed before the end of the data is reached, the 
( user's end-of-data routine is not entered. 


If another volume is required (end-of-volume condition), data management 
obtains the next volume serial number from the JFCB and performs volume 
switching. If the new volume is not already mounted, the EOV routine issues a 
mount message to the operator. 


When multiple tape units are being used, the EOV routine also checks to see if 
a next-plus-one volume is specified, and if the volume just completed can be 
vn rewound and unloaded. If so, the EOV routine issues a message directing the 
( | operator to mount the next-plus-one volume on the tape unit just used. This is 
a premounting aid; the next-plus-one volume label ts not verified at this time. 


Checking the Next Volume 
When volume switching is performed for multiple volume input, the EOV routine 
checks the volume and header labels on the new volume. 


The VOL1 label ts checked as if it were the first volume of the group; that is, the 
volume serial number is verified to ensure that the correct volume Is mounted. 


If the system-wide RACF tape protection has been specified, RACF access 
authorization to the volume is checked. READ authorization is required if open 
for INPUT or RDBACK. If open for INOUT or OUTIN, UPDATE authorization is 
checked. If a new concatenated data set is not being processed and the open 
-_ is for INOUT or OUTIN (not INPUT or RDBACK), it will further be verified that, if 
( the new volume is RACF defined, it is defined as part of the same volume set 
profile as the previous volume. 
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Processing continues normally if: 
e The new volume is not defined to RACF or 


« The user is authorized. 


For a specific volume request, the program is abnormally terminated if: 
e The new volume is defined to RACF and 


e The user is not authorized. 


For a nonspecific volume request, the operator is asked to mount a new 
volume. 


If the user is READ authorized but not UPDATE authorized, and the data set is 
open for INPUT or RDBACK, but the tape its not file protected, the volume is 
demounted and the operator is instructed to remove the write-enable (file 
protect) ring and remount the tape. | 


The method of locating and checking the HDR1 label varies according to the 
Situation. The processing depends on whether the data set is a continuation of 
a multivolume data set or is a concatenated data set. (Data sets with like char- 
acteristics can be processed using the same data control block (DCB), 
input/output block (IOB), and channel program.) In either case, the user exit for 
security verification may be taken, as described in “Open/EOV User Exit for 
security Verification” on page 22. 


e Multivolume data set: The data set sequence number is irrelevant for the | 
second and subsequent volumes of a multivolume data set. The EOV 
routine assumes that the data set continues at the beginning of the new 
volume and, therefore, checks the first header label group on the tape. The 
HDR1 label is checked in the same manner as when the data set was 
opened on the first volume. If the data set name is not the same, or the 
password was not verified for each volume, processing is abnormally termi- 
nated. 


e Concatenated data sets: The EOV routine handles concatenated data sets 
with like characteristics. Such data sets are not necessarily the first on the 
volume, so the EOV routine positions the tape according to the specified 
data set sequence number. This positioning is the same as for opening a 
data set. The HDR1 label is checked in the same manner as when the first 
data set was opened, including verification of the password if protection is 
indicated. 


The HDR2 label on the new volume is not processed. The data set character- 
istics that were established when the data set was opened apply to all subse- 
quent volumes handled by the EOV routine. 


The data set’s block count is not accumulated from volume to volume. It is ini- 
tialized and verified separately for each volume. 
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Closing an Input Data Set 


( The close routine does not process trailer labels on an input data set. Usually, 

. the trailer labels are processed by the EOV routine before the data Set is 
closed, unless deferred user input trailer label processing was specified in the 
data control block (DCB) exit list. If deferred user input trailer label processing 
was specified, the processing otherwise performed for an input end-of-data con- 
dition is performed when an input data set is closed. 


lf an input data set is closed before it reaches the end-of-data or the end-of- 
volume, or if the FEOV macro instruction is executed, processing of trailer 
labels is omitted. 


Creating a Volume Label 


The IBM standard volume label (VOL1) is usually written by a utility program 
L when the reel of tape is first received at the installation. At that time, a perma- 
( nent volume serial number is assigned to the reel, physically posted on the 
reel, and recorded in the VOL1 label. 


You can use the IBM-supplied JEHINITT utility program to create IBM standard 
volume labels. IEHINITT initializes the tape by writing in the following order: 


1. A volume label (VOL1) with the volume serial number and owner identifica- 
tion that you specify. You cannot specify any other fields of the VOL1 label. 


7 2. Adummy header label (HDR1 followed by 76 EBCDIC zeros). 
{ 3. A tapemark. 


The JEHINITT utility program can write a volume label on a labeled, unlabeled, 
or blank tape; it makes no checks to see what data, if any, previously existed 
on the tape. Therefore, IEHINITT does not check for password or RACF security 
protection; it does not create, modify, or delete RACEF profiles of RACF-defined 
volumes. Detailed procedures for using the program are described in Utilities. 


Methods other than the IEHINITT utility program can be used to write volume 
o—. labels. You can use a card-to-tape program, or you can replace the 
( IBM-supplied volume label editor routine (see Chapter 6, “Volume Label Verifi- 
cation and Volume Label Editor Routines” on page 113) with one that writes 
volume labels. If you use an editor routine to write the volume label, some 
data or a tapemark should already exist on the tape; otherwise, data manage- 
ment reads through the entire reel of blank tape looking for a label. 


Except for the IBM 3480 Tape Subsystem, the VOL1 label is rewritten by the 
open or EOV routine if all the following conditions are met: 

¢ QUTPUT or OUTIN is specified in the OPEN acto usucton: 

¢ The tape is positioned to the first data set on the volume. 

e Either of the following two conditions are true: 


— The data set is not password protected, or | | 
— The volume is RACF protected, the system-wide RACF tape protection 
option has been specified, and the user is ALTER authorized. 
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All VOL1 labels that can be successfully read under these conditions are 
rewritten. 


On an IBM 3480 Magnetic Tape Subsystem the open and EOV modules bypass eS 
rewriting a VOL1 label, thus improving performance. 


If you request a standard labeled (SL, SUL) output volume and the tape that you 
are allocated is recorded in the wrong density and cannot be read, the VOL‘ 
label is rewritten in the density that you specify. This facility allows you to 
make nonspecific requests (that is, you need not specify a volume serial 
number in your DD statement) for output tapes and allows the operator to 
mount any available scratch tape to answer your request. However, if the 
system-wide RACEF tape protection option has been specified, the volume is 
rejected, because it cannot be verified that it is not a RACF-protected volume. 


If you make a nonspecific output volume request for a standard labeled (SL, 

SUL) tape and the mounted volume is an NL or NSL labeled tape, the open or 

the EOV routine creates a volume label {VOL1) and sends a message to the —_ 
console operator requesting serial number and owner information. ——, 


Ferrey eR Rt ee th er nse reer everett errr reese sh rarer newerenn Ane nrsvrmnwr venereum i reer rater rrr env weerejonserwnssnanntntnesst st 


Opening an Output Data Set 


If IBM standard labels are specified, the first existing record on the output tape 

must be an IBM standard volume label (VOL1). At the time the data set Is 

opened, data management checks the first existing record on the tape to deter- 

mine whether the record is 80 bytes long and contains the identifier VOL1 in the 

first 4 bytes. The various error conditions that can occur during verification of — 
the first record are explained in Chapter 6, “Volume Label Verification and te 
Volume Label Editor Routines” on page 113. 7 


If the system-wide RACF tape protection option has been specified and the DD 

statement has specified PROTECT = YES, and the DD statement has not been 

previously opened for output processing, open ensures the PROTECT = YES 

specification is valid; both the volume sequence number and the file sequence 

number must be set to one and a private volume must be requested. The pro- 

tection indicator in the JFCB its reset so that subsequent OPENs of that DD 

statement for output processing will not attempt validity checking (of the —_— 
PROTECT = YES specification) and definition of the volume to RACF. | ew 


Volume Serial Number 
You are not required to specify volume serial numbers for output tapes. If none 
is specified, the mount message directs the operator to mount a scratch tape. 
Data management obtains the volume serial number from the VOL1 label and 
records it in the JFCB and the UCB. A user exit is provided to allow you to 
identify a specific tape volume in place of a nonspecific (scratch) volume. The 
exit is invoked when open or EOV is to issue a mount request for a volume for 
which no volume serial number has been specified, and will get control before 
the mount message is issued. For more information on the “Open/EOV nonspe- 
cific tape volume mount” exit, see Data Facility Product: Customization. 


If you choose to specify the volume serial number, data management compares , 
it with the volume serial number shown in the VOL1 label. If the number ts a 
correct, data management resets a mount switch in the unit control block to i 
indicate that volume mounting is verified (the switch is initially set when the 
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mount message is issued to the operator). If the volume serial number is incor- 
rect, data management may give the operator the option of having the label 
rewritten with the serial number of the volume requested. This will occur if the 
tape is not password protected, is not date protected, or is not a 
checkpoint/restart volume. Otherwise, data management rejects the tape and 
issues another mount message. Volumes are requested for mounting in the 
order specified. 


If the system-wide RACF tape protection option has been specified, RACF 
authorization at the UPDATE level is checked. If the tape volume is not defined 
to RACF, or if the tape volume is defined and the user is UPDATE authorized 
and PROTECT= YES has been specified, processing continues. If the tape 
volume is defined and either the user is UPDATE authorized and 

PROTECT =YES has been specified, or the user is not UPDATE authorized, the 
volume will be rejected if a nonspecific request is made and the program will 
be abnormally terminated if a specific request is made. 


Note: Beginning with RACF 1.7, if you specify PROTECT = YES in a DD state- 
ment for a volume or data set that you previously protected in this manner, you 
do not abnormally terminate due to this latter PROTECT = YES specification. 


Positioning the Volume to the Data Set 


When the volume is mounted and verified, data management positions the tape 
to receive the new data set. Usually the new data set will be the first and only 
data set on the tape, so the tape remains positioned immediately following the 
VOL1 label. 


To create a data set that follows another data set already stored on the tape, 
you specify a data set sequence number in the LABEL parameter of the DD 
statement. 


e The sequence number can be from 1 to 9999, with 1 representing the first 
data set on the volume. If the volume ends with EOV labels before the 
specified sequence number, the open routine will switch to the next volume. 
If you specify a sequence number that is greater than the number of data 
sets existing on the volume, plus one, your task will be abnormally termi- 
nated. 


e If you do not specify a sequence number, or specify zero, data management 
assumes that the data set is to be written as the first on the volume. 


To position the tape, data management maintains a logical data set sequence 
number in the unit control block (UCB). The method of positioning is the same 
as that previously explained for opening an input data set. 


Only one data set on a tape volume can be open at any given time. If you 
attempt to open another data set on the same volume, processing is abnor- 
mally terminated. This restriction includes system output (SYSOUT) tapes. 


When the tape is positioned to receive the new data set, data management 
expects to find either an existing HDR1 label or a tapemark. If neither is 
present, data management assumes that other data is recorded where the 
HDR1 label should be, and processing is therefore abnormally terminated. (lf 
the last data set on a tape has EOV labels, another data set cannot be written 
to follow it.) 
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If a tapemark is found, it indicates that a HDR1 label does not exist at the posi- 
tion at which the new data set is to be written. Data management bypasses all 
further label verification and accepts the tape for output. The conditions under f ~ 
which data management finds a tapemark instead of a HDR1 label are: a 


¢ When a tapemark immediately follows the VOL1 label. This may occur 
when the tape is initialized by means other than the JEHINITT utility 
program (IEHINITT writes a dummy HDR1 label following the VOL1 label). 
The tapemark is overwritten by the new HDR1 label. 


e When the new data set is to be written after the last existing data set on the 
volume (for multiple data set organizations). In this case, data manage- 
ment encounters the second tapemark following the existing EOF trailer 
label group. The tapemark is overwritten by the new HDR‘1 label. 


If data management finds an existing HDR1 label, it checks the label to deter- 
mine whether the existing data set may be overlaid. 


High Speed Search on an IBM 3480 Tape Volume _ 
When you want to extend a data set on an IBM 3480 tape volume, either using \ / 
DISP=MOD, OUTINX, or EXTEND, you can use the high speed search function. 
This function quickly positions the volume to the end of the requested data set. 
The tape moves at approximately twice the normal transport speed. After the 
tape is positioned, the open module processes the trailer labels of the data set 
to be extended. 


To invoke the high speed search function when extending a data set, you use 
the high speed search interface. Do the following: 


1. Obtain the job file control block (JFCB) for the requested data set (using the 7 
read JFCB—RDJFCB—macro). Se 


2. Set the “fast positioning” indicator in the JFCB (JFCPOSID in JFCBFLG3). 
3. Set the block identifier in the JFCB (JFCRBIDO = bik-id). 
4. Execute OPEN TYPE=J with the modified JFCB. 


The block identifier for high speed positioning is for the tape mark immediately 
following the last block of user data. You can obtain the block identifier when 


the data set is created by issuing the NOTE macro with the ABS parameter a 
before issuing CLOSE. This can be done only with BSAM or EXCP, not with ea 
QSAM. 


A similar method is used when you want to use the high speed search function 
to quickly position the volume to the beginning of the data set. The difference 
is that the block identifier is for the first standard header label of the requested 
data set when positioning to the beginning of the data set. 


For more information about the high speed header label search function, see 
IBM 3480 Magnetic Tape Subsystem User’s Reference, GC35-0099. 


lf a JFCB, with the “fast positioning” indicator on, is used by an open routine 
that is not TYPE =J, the “fast positioning” indicator will be reset. 


When “fast positioning” is indicated but a block identifier is not specified (in f- 


JFCRBIDO), OPEN TYPE =J will position the tape normally and insert a block es 
identifier (in JFCRBIDO). The block identifier is either for the first header label 
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when opening to the beginning of a data set or for the tape mark immediately 
following the last block of user data when opening to extend a data set. 


Once you have turned on the “fast positioning” indicator in a JFCB for an OPEN 
with TYPE=J in a job step, you should make sure the “fast positioning” indi- 
cator and the block identifier (in JFECRBIDO) reflect your intentions before any 
Subsequent OPEN with TYPE=J for the same data set. 


After OPEN with TYPE =J uses JFCRBIDO for a high speed search, it clears 
JFCRBIDO itn the system copy of the JFCB to prevent misinterpretation in a sub- 
sequent OPEN. 


Open/EOV User Exit for Security Verification 


For APF-authorized programs for which the program property “bypass pass- 
word (and RACF) checking” is active, a user exit is provided for verifying that a 
tape selected by open or EOV should be used, and whether certain security 
checks may be bypassed. For more information on the “Open/EOV volume 
security and verification” exit, see Data Facility Product: Customization. 


Expiration Date on Existing Label 


The existing HDR1 label is inspected for the expiration date. If the expiration 
date has not been reached, the operator is asked to confirm use of the tape or 
to mount another tape. 


If other data sets exist on the same volume, data management checks only the 
one expiration date and assumes that all following data sets expire on the 
same date. 


Password Protection and Data Set Name on Existing Label 


After checking the expiration date, data management inspects the security indi- 
cator in the existing HDR1 label. This indicator shows whether the existing data 
set is protected against unauthorized use. 


lf no protection is indicated, the tape is accepted for output. Data management 
does not request a password, and does not check the data set name. 


If protection is indicated, data management compares the data set name shown 
in the existing HDR1 label to the name specified by the user in the DD state- 
ment. If the names are not the same, processing is abnormally terminated 
unless the data set Is the first one on the first or only volume. In this case, 
even if you specify a specific volume, the operator will be requested to demount 
the tape and mount a new scratch tape. If a security- protected data set is 
deleted, the data set security byte in the HDR1 label must be set to 0 before the 
volume can be written on again. This can be done by using either the IEHINITT 
utility or a user program to relabel the volume. 


Two additional restraints are placed on creation of password-protected data 
Sets: 


e If you want to create a password-protected data set following an existing 
password-protected data set, you must supply the password of the existing 
data set. The security indicator must be the same in both the existing and 
the new data set. This consistency test is made even if the volume has 
been found to be defined to RACF. 
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e When creating a multivolume, password-protected data set, the second and 
successive volumes will also be verified. Verification consists of ensuring 
that the data set name in the JFCB is the same as the data set name in the 
password record and that the protection-mode indicator allows writing to 
the data set. 





If the data set name is correct and if the tape volume has not been found to be 
RACF defined, data management requests the operator or TSO terminal user to 
key in the required password. The password is verified in a user-established 
password data set. This password data set contains the data set name, the 
password, and a protection-mode indicator. The protection-mode indicator is 
set to permit either read/write or read-only operations. The read/write mode is 
necessary for output data sets. Processing is terminated if: 


e The operator or TSO terminal user, in two attempts, does not supply the 
correct password. 


e The password record for the data set to be opened does not exist in the 
password data set. — 


e The read-only protection mode is specified. | Moy 


System — Data Administration describes data set protection in detail, and con- 
tains the information you need to create and maintain the password data set. 


Note: Verification of existing labels is considered complete after checking the 
HDR1 label. Any labels, data, data sets, or tapemarks following the HDR1 label 
are irrelevant and may be overlaid by the new output. 


Writing Data Set Header Labels —_ 
When the tape is accepted by data management for output, data management ed 
creates the header labels (HDR1 and HDR2) for the new data set. These labels 
are created from information in the updated JFCB and other system control 
blocks. 


The source of information for each field of each label is explained in the 
description of label formats. The process of updating the JFCB is explained in 
the introduction. 


The security indicator is set in the HDR1 label even if the volume is RACF 
defined. eee 


If no user header labels are to be written, data management writes a tapemark 
after the HDR2 label. The tape is then ready to receive the new data set. 


Writing User Header Labels 
When SUL is coded on the DD statement and the address of an output user 
header label routine is specified in the DCB exit list, data management can 
write as many as eight user header labels (UHL1 to UHL8). 
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Permanent I/O Error 
lf a permanent I/O error occurs during label processing, and the data set is the 
first one on the first or only volume, the operator will be requested to demount 
the tape and mount a scratch tape, even if you request a specific volume. If the 
data set is not the first one on the volume or this is not the first volume of a 
multivolume data set, the job will be abnormally terminated. 





End-of-Volume on Output 


Data management’s EOV routine automatically switches volumes when an end- 
of-volume condition occurs, that is, when a reflective strip is encountered or 
when a FEOV macro instruction is executed. This volume switching includes: 


e Writing trailer labels on the current volume 
« Checking existing labels on the new volume 


e Writing header labels on the new volume 


When multiple tape units are being used, the EOV routine also checks to see if 
a next-plus-one volume is needed, and if the volume just written can be 
rewound and unloaded. If so, the EOV routine issues a message directing the 
operator to mount the next-plus-one volume on the tape unit just used. This is 
a premounting aid; the next-plus-one volume label is not verified at this time. 


Writing Data Set Trailer Labels 
Trailer labels are always written at an end-of-volume condition on output tapes. 
( These labels are identified as EOV1 and EOV2 (as opposed to EOF for end of 
L data). These labels are created in the same manner and with the same content 
as the data set header labels, except for the label identifiers and the block 
count. 


At end of volume, one tapemark ts written following the data set trailer labels 
(instead of two tapemarks for end of data). If user trailer labels are to be 
written, the tapemark follows the user labels. 


Writing User Trailer Labels 
When SUL is coded on the DD statement and the address of an output user 
trailer label routine is specified in the DCB exit list, data management can write 
as many as eight user trailer labels (UTL1 to UTL8). 





Labels on New Volume 
The EOV routine handles label processing on the new volume (checking 
existing labels and writing new labels). The processing is the same as the 
open routine’s handling of the first volume. The user exit for security verifica- 
tion may be taken, as described in “Open/EOV User Exit for Security 
Verification’ on page 371. 


When creating a multivolume data set, the data set sequence number is irrel- 
evant for the second and subsequent volumes. The EOV routine assumes that 
the data set continues at the beginning of the new volume. 
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RACF Processing on the New Volume 


If the system-wide RACF tape protection option has been spncined RACF 
authorization checking will occur for the new volume. If the previous volume is 
RACF protected, the new volume must either be not defined to RACF (in which 
case EOV will define it to RACF as part of the previous volume’s volume set 
profile), or the new volume must be defined as part of the same volume set 
profile as the previous volume. If the previous volume is not RACF protected, 
then the new volume must not be RACF protected. If the above conditions are 
not met, the new volume will be rejected if a nonspecific request is made, or 
the program will be abnormally terminated if a specific request is made. 


Special End-of-Volume Conditions 


When a reflective strip causes an end-of-volume condition during the writing of 
data, the EOV routine writes the trailer labels as described above. If the reflec- 
tive strip is encountered while writing the trailer labels, the EOV or the close 
routine continues to write the trailer labels. In both cases, the data set can be 
read or overwritten normally even though it crosses the reflective strip. 


lf you add another data set to a tape (multiple data set organization) on which 
the last existing trailer label group crossed the reflective strip, or on which the 
new header label group crosses the reflective strip, data management: 


e Writes the new header label group 
e Allows the user to write one record 
e Writes the new trailer label group 


e Performs volume switching 


Closing an Output Data Set 


The close routine handles end-of-data-set processing on output tapes. When a 
write operation is the last operation that occurs before closing a data set (for 
OUTPUT, OUTIN, or INOUT) or when no output Is written before closing (for 
OUTPUT or OUTIN), the close routine creates data set trailer labels. 


Writing Data Set Trailer Labels 


The close routine writes the data set trailer labels with the identifiers EOQF1 and 
EOF2. Except for the label identifiers and the block count, these labels are 
created in the same manner and with the same content as the data set header 
labels. 


The close routine writes two tapemarks following the trailer labels. If user 
labels are to be written, the tapemarks follow the user trailer labels. If another 
data set is added to the tape (multiple data set organization), its HDR1 label 
overlays the second tapemark. 


Writing User Trailer Labels 


When SUL Is coded on the DD statement and the address of an output user 
trailer label routine is specified in the DCB exit list, the close routine can write 
as many as eight user trailer labels (UTL1-UTL8). 
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IBM 3480 Tape Processing 
( To improve performance when processing labels of standard labeled volumes 
. | on an IBM 3480 Tape Subsystem (with or without Improved Data Recording 
| Capability), the open and EOV routines attempt to avoid changing the direction 
of tape movement. 


Restarting from a Checkpoint 


When a job step is restarted from a checkpoint, the restart routine repositions 
tape volumes containing data sets that were open when the checkpoint was 
taken. Specifically, the restart routine: 


1. Restores applicable control blocks to the conditions that existed when the 
checkpoint was taken. 


2. Ensures that the first existing record on the tape is a standard volume label 
( (VOL1), and verifies the volume serial number shown in the label. 


3. Uses the data set sequence number shown in the JFCB to position the tape 
at the interrecord gap preceding the first record of the required data set. 
The method of positioning is the same as previously explained for opening 
an input data set. The data set labels are not reprocessed. 


4. Uses the block count shown in the DCB to reposition the tape at the proper 
record within the data set. This positioning is always performed in a 
forward direction. {If the block count is 0 or a negative number, the tape 
remains positioned at the interrecord gap preceding the first record. 


( | lf a SYSOUT data set was open when the checkpoint was taken, the data set 
written into during restart differs from the data set used originally. The system 
writes job separators at the beginning of the SYSOUT data set used during 
restart. 
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Format of the IBM Standard Volume Label (VOL1) 7 


The IBM standard volume label (VOL1) is 80 characters in length and is used to a | 
identify the tape volume and its owner. It is always the first record on an IBM acd 
Standard labeled tape. It is recorded in EBCDIC on 9-track tape units, or in 

BCD on /-track tape units. 


Figure 7 on page 37 shows the format of the volume label. The shaded areas 
represent fields that are recorded in the label, but are not used or verified 
during processing. The contents and processing of each field of the label are 
described below. The processing descriptions refer to the following system 
control blocks: 


e Job file control block (JFCB) 
e Unit control block (UCB) 


as 
. 
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Position (Bytes) Field Number and Name 





1) Label Identifier 
* VOL 1 


2) Label Number | 


od 


© Volume Serial Number 





cgmyenpmemeney aime apnea pad 
Oo Reserved 





5) VTOC Pointer 
{Direct Access Only} 


— 


© Reserved 


| 








@ Owner Narre and Adcress Cade 





| Functional field. 


Ne processing 
furction at the 
present time. 


8 Reserved 





Figure 7. Format of IBM Standard Volume Label 
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1—Label Identifier (3 bytes) 
¢ Contents: The characters VOL identify this label as a volume label. 


e Processing: This field is read to verify that a standard labeled tape is 
mounted, and that this label is a volume label. 


The labels are created initially by the IEHINITT utility program or a user’s 
program. 


In the following situations, open or EOV routines create a standard volume 
label based on specifications in your DD statement: 


— When you request a standard labeled (SL, SUL) output volume, and an 
NL or NSL labeled volume is mounted to satisfy your request 


— When you request a standard labeled (SL, SUL) output volume, anda 
volume that can be overwritten and that is recorded in the wrong 
density is mounted to satisfy your request 


2—Label Number (1 byte) 


¢ Contents: The relative position of this label within a set of labels of the 
same type; it is always a1 for the IBM standard volume label. 


¢ Processing: Verified in conjunction with Field 1 to identify this label as 
VOL1. 


3—Volume Serial Number (6 bytes) 


¢ Contents: A unique identification code that is assigned through IEHINITT to 
the volume when it enters the system, or that is assigned by the operator 
when the open or EOV routines label the volume. This code may also 
appear on the external surface of the volume for visual identification. The 
code is normally numeric characters (000001 to 999999), but may be any six 
alphameric characters. It may be from one to six characters, but, if fewer 
than six characters, the code must be left-justified, and the remainder is 
padded with blanks. 


If the volume serial number is assigned in the JCL statements, all national 
characters, the hyphen, and other special characters are accepted when 
enclosed in apostrophes. However, their use is not recommended, because 
difficulties can occur in recognizing volume serial numbers when typewriter 
heads and print chains with nonalphameric characters are used. 


If the volume serial number is assigned through the IEHINITT utility 
program, A through Z, 0 through 9, and the hyphen are the only valid char- 
acters that may be specified. 


e Processing. The user-specified volume serial number is obtained from the 
JFCB and recorded in the UCB. Then the number in the UCB is compared 
to the number in this field of the label to ensure that the correct volume is 
mounted. 


For scratch output tapes, the volume serial number is obtained from this 
field of the label and recorded in both the JFCB and the UCB. 


The IEHINITT utility program can create this label with a volume serial 
number of up to six characters. The number is left-justified and the 
remainder of this field is padded with blanks. 
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4—Reserved (1 byte) 
« Contents: Reserved for possible future use—initialized as a blank or zero. 


¢ ¢ Processing: Not used. 


5—VTOC Pointer (10 bytes) 


e Contents: Direct access volumes only. This field is not used for tape 
volumes and should be recorded as blanks. 


e Processing. Not used or verified. The IEHINITT utility program writes 
blanks in this field. 


6—Reserved (20 bytes) 
« Contents: Reserved for possible future use—should be recorded as blanks. 
« Processing. Not used or verified. The JEHINITT utility program writes 
blanks In this field. 
( 7—Owner Name and Address Code (10 bytes) 


e Contents: Indicates a specific customer, person, installation, department, 
and so forth, to which the volume belongs. Any code or name is accept- 
able. 


e Processing: Not used or verified. The IEHINITT utility program writes the 
text specified by the user, and the open and EOV routines write the text 
| Specified by the operator. If the code is less than 10 bytes long, it is left- 
| justified and the remainder of the field is padded with blanks. 


( 8—Reserved (29 bytes) 


e Contents: Reserved for possible future use—should be recorded as blanks. 


¢ Processing: Not used or verified. The IEHINITT utility program writes 
blanks in this field. 
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Format of IBM Standard Data Set Label 1 (HDR1/EOV1/EOF1) 


an 
IBM standard data set label 1 is 80 characters in length and describes the asso- ef 
ciated data set. The format is used for header labels (HDR1), end-of-volume ic 
trailer labels (EOV1), and end-of-data-set trailer labels (EOF1). Data set label 1 
is always followed by data set label 2. It is recorded in EBCDIC on 9-track tape 
units, or in BCD on 7-track tape units. 
Figure 8 on page 41 shows the format of data set label 1. The shaded areas 
represent fields that the operating system writes in the label, but that are not 
used or verified during processing. The contents and processing of each field 
of the label are described below. The processing descriptions refer to the fol- 
lowing system control blocks: 
¢ Communication vector table (CVT) 
¢« Data control block (DCB) 
¢ Data extent block (DEB) — 
* Job file control block (JFCB) toe 
e Unit control block (UCB) 
_ 
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Position Bytes Field Number and Name 








(3) : @ Label identifier | 


pes | Ree @ Label Number | 


at one @ da:a Set Identifier 


» HDR1/EOV 1/EOF 1 











Data Set Serial Number 


Yolume Sequence Number 





Data Set Sequence Number 





Generation Number 


Version Number 


Creation Date 


Expiratian Date 





Data Set Security 





Block Count 


“— 


System Code 





| | Functional field. 
Reserved | 
No processing 
furction at tne 
presenti time. 








Figure 8. Format of IBM Standard Data Set Label 1 





Chapter 2. IBM Standard Labels 41 





1—Label Identifier (3 bytes) 


* Contents: Three characters that identify the label are as follows: 
— HDR Header label (at the beginning of a data set) ee 


— EOV Trailer label (at the end of a tape volume, when 
the data set continues on another volume) 


— EOF Trailer label (at the end of a data set) 


e Processing: Data management checks this field to verify that the record is 
an IBM standard data set label. 


For input data sets, data management checks the label identifier to deter- 
mine whether data set processing is to be continued. When data manage- 
ment finds an EOV label, it performs volume switching. When data 
management finds an EOF label, it passes control to the user’s end-of-data 
routine. 


lf the DD statement specifies OPTCD =B for an input data set, the trailer 
label identifier (EOV or EOF) is not used to determine whether a volume 
switch is necessary. If more volumes are available, data management per- 
forms the switching. If no volumes are available, data management passes 
control to the user’s end-of-data routine. 


When creating trailer labels, the EOV routine writes EOV in this field, and 
the close routine writes EOF. | 


2—Label Number (1 byte) 


¢ Contents: The relative position of this label within a set of labels of the 
Same type; It is always a 1 for data set label 1. 


e Processing: Verified and written in conjunction with Field 1 to identify this 
label as HDR1, EOV1, or EOF1. 


3—Data Set Identifier (17 bytes) 


e Contents: The rightmost 17 bytes of the data set name (includes GxxxxVyy 
if the data set is part of a generation data group). If the data set name is 
less than 17 bytes, it is left-justified and the remainder of this field is 
padded with blanks. If the name contains embedded blanks or other = 
special characters, you must enclose the name in apostrophes on the DD | 
statement that requests this data set. JCL User’s Guide lists the restrictions 
that apply to enclosing a data set name in apostrophes. The apostrophes 
do not appear in the data set identifier field. 


e Processing: For input, this name is compared to the user-specified data set 
name found in the JFCB. This ensures that the correct data set is being 
processed. 


For output, the data set name in the existing label is verified in conjunction 
with password protection to determine whether the existing data set can be 
overwritten. If protection is not specified, the data set name is not checked. 


OS tape input files can accept generation data group members written in 

DOS format. That is, on input, the operating system can verify the file name 

field on a DOS tape, excluding the generation and version number as a 

level of qualification, and verify the generation and version number fields in 
addition to the file name field. 
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When creating labels for a new data set, the user-specified data set name is 
obtained from the JFCB and recorded in this field. 





4—Data Set Serial Number (6 bytes) 


¢ Contents: The volume serial number of the tape volume containing the data 
set. For multivolume data sets, this field contains the serial number of the 
first volume of the aggregate created at the same time. The serial number 
Can be any six alphameric characters, normally numeric (000001 to 999999). 
The number may be from one to six characters, but, if fewer than six char- 
acters, the code must be left-justified and followed by blanks. Although all 
national characters, the hyphen, and other special characters are accepted 
when enclosed by apostrophes, their use is not recommended. This is 
because difficulties can occur in recognizing volume serial numbers when 
typewriter heads and print chains with nonalphameric characters are used. 


¢ Processing: Not used or verified. When creating labels, the serial number 
is obtained from the UCB and recorded in this field. 


5—Volume Sequence Number (4 bytes) 


« Contents: A number (0001 to 9999) that indicates the order of the volume 
within the multivolume group created at the same time. This number is 
always 0001 for a single volume data set. 


¢ Processing: Not used or verified. When creating labels, the open routine 
writes 0001 in this field; the EOV and close routines obtain the current 
volume sequence number from the DEB. 


6—Data Set Sequence Number (4 bytes) 


¢ Contents: A number (0001 to 9999) that indicates the relative position of the 
data set within a multiple data set group. This number is always 0001 for a 
single data set organization. 


¢ Processing: This number in the first HDR1 label on the tape is referred to 
when the open routine positions the tape. If this number in the first HDR1 
label and the requested data set sequence number in the JFCB are both 
greater than 1, the logical data set sequence number in the UCB is set to 
the number in the label. Otherwise, the logical data set sequence number 
in the UCB is set to 1. 


When creating labels, the open and close routines obtain the user-specified 
data set sequence number from the JFCB (a 0 is changed to 1). The EOV 
routine obtains this number from the logical data set sequence number in 
the UCB. 


7—Generation Number (4 bytes) 


¢ Contents: If the data set is part of a generation data group, this field con- 
tains a number from 0001 to 9999 indicating the absolute generation number 
(the first generation is recorded as 0001). If the data set is not part of a 
generation data group, this field contains blanks. 


¢ Processing: Not used or verified. The generation number is available as 
part of the data set name in Field 3 of this label. 


When creating labels, data management checks the JFCB to determine. 
whether the data set is part of a generation data group. If so, the gener- 
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ation number is obtained from the last part of the data set name in the 
JFCB. Otherwise, this field is recorded as blanks. 


eR, 





8—Version Number (2 bytes) 


¢ Contents: If the data set is part of a generation data group, this field con- 
tains a number from 00 to 99 indicating the version number of the gener- 
ation (the first version is recorded as 00). If the data set is not part of a 
generation data group, this field contains blanks. — 


e Processing: Not used or verified. The version number is available as part 
of the data set name in Field 3 of this label. 


When creating labels, data management checks the JFCB to determine 
whether the data set is part of a generation group. If so, the version 
number is obtained from the last part of the data set name in the JFCB. 
Otherwise, this field is recorded as blanks. 


9—Creation Date (6 bytes) 


« Contents: Year and day of the year when the data set was created. The 
date is shown in the format cyyddd, where: 


century (blank=19; 0=20; 1=21; etc.) 
year (00-99) 
day (001-366) 


C 


yy 
ddd 


¢ Processing: Not verified. When data management creates labels, the date 
is obtained from the JFCB. This is the date the job was initiated for exe- 
cution, and not necessarily the date the label was created. 


10—Expiration Date (6 bytes) ~* 


¢ Contents: Year and day of the year the data set may be scratched or over- 
written. The date is shown in the format cyyddd, where: 


c = century (blank=19; 0=20; 1=21; etc.) 
yy = year (00-99) 
ddd = day (001-366) 


e Processing: For input, not used or verified. For output, the expiration date 
in the existing label is compared to the current date shown in the communi- 
cations vector table (CVT). If the date in the label is greater than the 
current date, the operator receives a message and is given the option of 
using the tape or mounting another. If any other data sets follow on the 
same volume, they are considered to expire on the same day. 


When creating labels, data management obtains the expiration date from 
the JFCB. If you did not specify a retention period or expiration date, the 
expiration date is recorded as zeros and the data set is considered to have 
expired. 


11—Data Set Security (1 byte) 


e Contents: A code number indicating the security status of the data set is as 
follows: 


QO No password protection. 


1 Password protection. Additional identification of the data set is required 
before it can be read, written, or deleted. (Ignored if volume is RACF 
defined.) 
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3. Password protection. Additional identification of the data set Is required 
before it can be written or deleted. (Ignored if volume is RACF defined.) 


¢ Processing: For input, data management inspects this field on a single 
volume data set, on each concatenated data set, and on each volume of a 
multivolume data set. If protection is specified in this field, data manage- 
ment verifies the password furnished by the operator and sets a security 
indicator in the JFCB. 


For output, data management inspects this field in the existing HDR1 label. 
If security is specified, the existing data set cannot be overwritten until data 
management verifies the password and the data set name in Field 3 of this 
label. If you specify a data set name different from the one in Field 3, and 
the data set is the first one on the first or only volume, the operator is 
requested to demount the tape and mount a scratch tape, even though you 
requested a specific volume. If the data set is not the first one on the 
volume or this is not the first volume of a multivolume data set, the job is 
abnormally terminated. 


When the second or greater data set on a volume is created and there is no 
HDR1 label with which to determine security protection, open reads the 
EOF1 label of the preceding data set on the volume. The data set security 
level in the EOF1 label must match the security level requested for the new 
data set. If they are not equal, the job is abnormally terminated. If the 
security levels are equal and indicate no security protection, open proc- 
essing continues. If security protection is indicated, data management 
requests a password and verifies that the password furnished by the oper- 
ator allows access to the data set name in the EOF1 label, the preceding 
data set. It is important to note that, in this case, only the 17-byte data set 
name in the EOF1 label is available. Therefore, either the data set name 
must be 17 or fewer characters in length, or the last significant 17 charac- 
ters of the full data set name must be entered in the PASSWORD data set. 
It is recommended that security-protected tape data sets limit their data set 
names to 1/7 or fewer characters, or that the last 17 characters of the data 
set name be entered in the password data set together with the full data set 
name. 


When data management creates labels, the user’s request for security is 
determined from the indicator in the JFCB. 


12—Block Count (6 bytes) 


¢ Contents: This field in the trailer label shows the number of data blocks in 
the data set on the current volume. This field in the header label is always 
zeros (OO0000). 


¢ Processing: The DCB count is increased as the data set is read. The final 
DCB count is compared with the count in the trailer label at end of data or 
end of volume. If the counts do not agree, a user exit entry in the DCB exit 
list determines whether processing will continue or abnormally terminate. 
If the appropriate user exit entry is not provided, a block count discrepancy 
causes processing to abnormally terminate. 


For read backward, the verification process is reversed. The trailer label 
count is recorded in the DCB and decreased as the data set is read. The 
final DCB count should be zero, which equals the count in the header label. 
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When data management creates labels, the block count in the header label 
is set to zeros. The block count in the trailer label is obtained from the 
DCB. 


If the data set was created with a DCB that had no device-dependent 
section, the block count is written as zero and is not verified. 
13—System Code (13 bytes) 
« Contents: A unique code that identifies the system: “IBM OS/VS 370’ 
e Processing: Not used or verified. When creating labels, the code is 
obtained from the JFCB, where it is always binary zeros. 
14—Reserved (7 bytes) 
e Contents: Reserved for possible future use—contains blanks. 


e Processing: Not used or verified. When creating labels, data management 
writes blanks in this field. 


Format of IBM Standard Data Set Label 2 (HDR2/EOV2/EOF2) 


IBM standard data set label 2 always follows data set label 1 and contains addi- 
tional information about the associated data set. The format is used for header 
labels (HDR2), end-of-volume trailer labels (EOV2), and end-of-data-set trailer 
labels (EOF2). The label is 80 characters in length. It is recorded in EBCDIC on 
9-track tape units, or in BCD on /7-track tape units. 


Figure 9 on page 47 shows the format of data set label 2. The shaded areas 
represent fields that the operating system writes in the label, but that are not 
used or verified during processing. The processing descriptions refer to the fol- 
lowing system control blocks: 


e Data control block (DCB) 

e Job file control block (JFCB) 
e Task input/output table (TIOT) 
e Unit control block (UCB) 
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Position (Bytes) Field Number and Name 








Label Idertifier 
Label Number | HDR2;EOV2/EOF2 


Record Format 


o 000 


Block Length 





© 


Record Length 








Tape Density 
Data Set Position 


~ To 





© Job‘Job Step Identification 





© Taoe Recording Techiique 
© Control Character 
@ Reserved 

Block Attribute 


© Reserved 





@)  Checkooint Data Set 
Identifier 


@ Reserved 


Functional field. 


No processing 
function at the 
present time. 











Figure 9. Formzt of IBM Standard Data Set Label 2 
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1—Label Identifier (3 bytes) 
© Contents: Three characters that identify the label are as follows: 
— HDR Header label (at the beginning of a data set) 


— EOV trailer label (at the end of a tape volume, when 
the data set continues on another volume) 


— EOF Trailer label (at the end of a data set) 


e Processing: Data management checks this field to verify that the record is 
an IBM standard data set label. 


For input data sets, data management checks the label identifier to deter- 
mine whether data set processing is to be continued. When data manage- 
ment finds an EOV label, it performs volume switching. When data 
management finds an EOF label, it passes control to the user’s end-of-data 
routine. 


If the DD statement specifies OPTCD =B for an input data set, data manage- 
ment accepts either EOV or EOF as the trailer label identifier, and the iden- 
tifier is not used to determine whether a volume switch is necessary. If 
more volumes are available, data management performs the switching. If 
no volumes are available, data management passes control to the user’s 
end-of-data routine. 


When creating trailer labels, the EOV routine writes EOV in this field, and 
the close routine writes EOF. 
2—Label Number (1 byte) 


¢ Contents: The relative position of this label within a set of labels of the 
same type; it is always a 2 for data set label 2. 


e Processing: Verified and written in conjunction with Field 1 to identify this 
label as HDR2, EOV2, or EOF2. 
3—Record Format (1 byte) 


¢ Contents: An alphabetic character that indicates the format of the records 
in the associated data set: 


— F Fixed length 
— V Variable length 
— U Undefined length 


e Processing: For input, the record format is obtained from this label and 
recorded in the JFCB (if the JFCB field is zero). Then the record format in 
the JFCB is recorded in the DCB (if the DCB field is zero). Note that this is 
a merging process in which existing specifications in the JFCB and DCB 
cannot be overridden. 


When creating labels, a reverse merge follows the forward merge described 
above. The record format in the DCB overrides the record format in the 
JFCB, and the updated JFCB provides the information for the label. 


This merging process is explained and illustrated in the introduction. 
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4—Block Length (5 bytes) 


e Contents: A number up to 32760 that indicates the block length, in bytes. 
Interpretation of the number depends on the associated record format in 
Field 3, as follows: 





— Format F Block length (must be a multiple of the 
logical record length in Field 5) 


— Format V Maximum block length (including the 4-byte 
length indicator in the blocks) 


— Format U Maximum block length 


e Processing: The number in the label is converted to binary and merged 
with appropriate fields in the JFCB and DCB. The merging process is the 
same as that for the record format code in Field 3 of this label. 


5—Record Length (5 bytes) 


aa ¢ Contents: A number that indicates the record length, in bytes. Interpreta- 
( tion of the number depends on the associated record format in Field 3, as 
follows: | 


— Format F Logical record length — 


— Format V Maximum logical record length (including 
the 4-byte length indicator in the records) 


— Format U Zeros 


7 ¢ Processing: The number in the label is converted to binary code and 
( - merged with the appropriate fields in the JEFCB and DCB. The merging 
et process is the same as for the record format code in Field 3 of this label. 


6—Tape Density (1 byte) 


¢ Contents: A code indicating the recording density of the tape; the code is 
equivalent to the DEN parameter value on the DD statement (for the DEN 
parameter values, refer to “Tape Characteristics’ on page 9). 


Note: Specifying DEN =O for a 7-track 3420 will result in 556 bits-per-inch 
7 recording, but corresponding messages and tape labels will indicate 200 
( ; | bits-per-inch recording density. For the 3480 tape, this field contains a 
3 | blank. 


¢ Processing: Not used or verified. When data management creates labels, 
the information for this field is obtained from the JFCB. 
7—Data Set Position (1 byte) 
« Contents: A code indicating a volume switch is as follows: 
O No volume switch has occurred 
1 Avolume switch previously occurred 


¢ Processing: Not used or verified. When creating labels, the open routine 
writes 0 in this field, and the EOV routine writes 1. The close routine deter- 
mines which code to write by comparing the volume serial number in the 
JFCB to the number in the UCB. It writes O if the numbers are equal, and 1 
if they are not equal. 
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8—Job/Job Step Identification (17 bytes) 


¢ Contents: Identification of the job and job step that created the data set. —_ 
For MOD processing, EOF2 contains the name of the job and job step that we 
extended it. The first 8 bytes contain the name of the job, the 9th byte iS a 
slash (/), and the final 8 bytes contain the name of the job step. 


¢ Processing: Not used or verified. When data management creates labels, 
the names of the job and job step are obtained from the TIOT. 
9—Tape Recording Technique (2 bytes) 


e Contents: A code or blanks indicating the tape recording technique used to 
create the data set. 


For 7-track tapes the values are: 
— Tb Odd parity with translation 


— Cb Odd parity with conversion 


— Eb Even parity with no translation J 
— ET Even parity with translation 
— bb Odd parity with no translation or conversion 
For the 3480 Magnetic Tape Subsystem with Improved Data Recording 
Capability, the values are: 
— Pb Record data in compacted format 
— bb Record data in standard 3480 format pe 
For other tapes, this field is recorded as blanks. The only technique avail- ae 
able for 9-track tape is odd parity and no translation. 
¢ Processing: For 7-track tape and the 3480 Magnetic Tape Subsystem with 
Improved Data Recording Capability, the specification in the label is con- 
verted to a bit code and merged with the appropriate fields of the JFCB and 
DCB. The merging process is the same as that for the record format code 
in Field 3 of this label. 
10—Control Character (1 byte) gore. 
¢ Contents: A printer control code indicating whether a control character set Se 
_ was used to create the data set and the type of control characters used: 
— A Contains ISO/ANSI/FIPS control characters 
— M Contains machine control characters 
— b Contains no control characters 
« Processing: The specification in the label is converted to a bit code merged 
to the appropriate fields of the JFCB and DCB. The merging process is the 
same as that for the record format code in Field 3 of this label. 
11—Reserved (1 byte) 
« Contents: Reserved for possible future use (recorded as blanks). 
¢ Processing: Not used or verified. When creating labels, data management g : 
writes blanks in this field. 7 


50 MVS/XA Magnetic Tape Labels and File Structure Administration 














12—Block Attribute (1 byte) 
( ~ ¢ Contents: A code indicating the block attribute used to create the data set: 
| — B Blocked records 
S Spanned records, if the record format byte = ‘V’ 
— $ Standard records, if the record format byte = ‘F’ 
R Blocked and spanned records, if the record format 
byte = ‘V’ 
— R Blocked and standard records, if the record format 
byte = ‘F’ 
— b Records that are not blocked and not spanned, or 


records that are not blocked and not standard 


* Processing: The specification in the label is converted to a bit code and 
i merged with the appropriate fields of the JFCB and DCB. The merging 
( process is the same as for the record format code in Field 3 of this label. 


13—Reserved (8 bytes) 


¢ Contents: For the 3420, bytes 40 through 42 are reserved, byte 43 contains 
the model number, and bytes 44 through 47 contain the last 4 digits of the 
serial number of the creating tape unit. For the 3480, bytes 40 through 42 
are reserved, bytes 43 through 46 contain the last 4 digits of the serial 
number of the control unit, and byte 47 contains the device address. 


same if the data set was opened for update or if DDR was used to swap 


( ; Note: The serial numbers in the header and trailer labels may not be the 
tape units while the data set was being created. 


¢ Processing: A unique number to identify the recording unit is read off the 
tape during open processing, converted into hexadecimal, and inserted into 
the UCBCTD field in the UCB tape extension. 


14—Checkpoint Data Set Identifier (1 byte) 


¢ Contents: This byte contains the character C if the data set is a secure 
pos checkpoint data set; the byte is blank if the data set is not a secure check- 
( point data set. 


e Processing: This field is examined by open/close/EOV and, if it finds the 
data set is a checkpoint data set, it performs the following security oper- 
ations: 


— Verifies (via messages to the operator) that the data set is a secure 
checkpoint data set. 


— Determines whether the user is authorized. If the user is unauthorized, 
open/close/EOV will not allow access to the checkpoint data set directly, 
although it will allow the taking of checkpoints and performing restarts. 

15—Reserved (32 bytes) 


« Contents: Reserved for possible future use (recorded as blanks). 


e Processing: Not used or verified. When creating labels, data management 
writes blanks in this field. 





Chapter 2. IBM Standard Labels 51 


Format of User Label (UHL1-UHL8, UTL1 -UTL8) 


IBM standard user labels contain user-specified information about the associ- 
ated data set. User labels are optional within the standard label groups. 





Figure 10 shows the format of user labels. The format is used for user header 

_ labels (UHL1-UHL8) and user trailer labels (UTL1-UTL8). The labels are 80 
characters in length. They are recorded in the density specified via JCL. 
seven-track tape records are in BCD. The contents and processing of each 
field of the label are described below. 


rrr 


Position (Bytes) Field Number and Name 


@ Label identifier 
| UHL 1-8/UTL.1-8 


@ abel Number | 








& User Soecifiec 











a oy 
, on we | 
| | Functional field. 
=) Fiele with no 
processing function. 
Figure 10. Format of User Label fo 
‘ y 


1—Label Identifier (3 bytes) 
e Contents: Three characters that identify the label are as follows: 
— UHL User header label {at the beginning of a data set) 


— UTL User trailer label (at the end-of-volume or 
end-of-data-set) 


¢ Processing: This field is read to verify that the record is a user label. Data 
management accepts either UHL or UTL. 
2—Label Number (1 byte) 


« Contents: The relative position of this label within a set of labels of the 
same type; it can be a number from 1 to 8. 





¢ Processing: This field is read to ensure that no more than eight user labels 
are processed. This field is read in conjunction with Field 1. 
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3—User Specified (76 bytes) 


¢ Contents: Specified by the user. 





¢ Processing: Specified in the DCB exit list. 
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( . Chapter 3. ISO/ANSI/FIPS Labels 
~ This chapter describes the organization, format, and processing of labels 


designed according to the specifications of the following industry standards as 
understood and interpreted by IBM as of April 1983: 


e ISO 1001-1979, level 4 

e ANSI X3.27-1978, level 4 

e Federal Information Processing Standard (FIPS) 79 
In this manual, the term “Version 3” is used when referring to these standards. 
The term “Version 1” is used when referring to the previous ISO 1001-1967 and 
ANSI X3.27-1969 standards. “ISO/ANSI” is used when referring to labels 


designed according to the specifications of Version 1 standards. 
“ISO/ANSI/FIPS” refers to Version 3 labels. 


( Only volumes with Version 3 labels will be created by the system. Volumes 
with Version 1 labels will be accepted for input, but Version 3 checking will not 
occur. 


ISO/ANSI/FIPS support will execute on a processor with a magnetic tape device 
that supports the specifications tn: 


e Information Processing—9-Track, 12.7mm (0.5in) Wide Magnetic Tape for 
Information Interchange, 32rpmm (800rpi), ISO 1863 


( ; ¢ Information Processing—9-Track, 12.7mm (0.5in) Wide Magnetic Tape for 
ad Information Interchange, 8 and 32rpmm (200 and 800rpi) NRZI, and 63rpmm 
(1600rpi), Phase Encoded, |SO 1864 


e Information Processing—9-Track, 12.7mm (0.5in) Wide Magnetic Tape for 
Information Interchange, 63rpmm (1600rpi), Phase Encoded, |SO 3788 


e American National Standard Recorded Magnetic Tape for Information Inter- 
change, 800cpi, NRZI, X3.22-1973 


¢ American National Standard Recorded Magnetic Tape for Information Inter- 
( change, 1600cpi, PE, X3.39-1973 


¢ American National Standard Recorded Magnetic Tape for Information Inter- 
change, 6250cpi Group-Coded Recording, X3.54-1976 


Both Information Processing—9-Track 12.7mm (0.5in) Wide Magnetic Tape for 
Information Interchange Recorded at 8rpmm (200rpi), |SQ 1862, and American 
National Standard Recorded Magnetic Tape for Information Interchange 200cpi 
NRZI, X3.13-1973, require a magnetic tape device not supported by MVS/XA, 
and tapes written according to those standards are not supported. 


All data on a tape with ISO/ANSI/FIPS labels must be recorded in the 128 char- 
acters of basic ISCII/ASCII. Do not use Version 3 volumes to contain raw 
binary, floating point, or packed decimal data {see “ISCII/ASCII Translation, ” 
below). Unlabeled tapes recorded in ISCII/ASCII can be processed, as explained 
in Chapter 5, “Unlabeled Tapes” on page 105. 
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summary of Version 3 Installation and Use Characteristics 


This section summarizes the main characteristics of installing support for and 
using Version 3 volumes. 





System Generation Requirements 
Operating system support for Version 3 consists of processing labels and trans- 
lating from ISCII/ASCII to EBCDIC on input and from EBCDIC to ISCII/ASCII on 
output. This support is included in the system (in module |GCO010C of 
SYS1.LPALIB) at system generation time PY specifying ASCII=INCLUDE in the 
CTRLPROG macro. 


When ISO/ANSI/FIPS support is included in the system, a class extension area 
is generated for each UCB that represents a tape device. This area is used by 
ISO/ANSI/FIPS processing. For more information, see Data Facility Product: 
Customization. 


ISCII/ASCII Translation Sasa 
The IBM-supplied translation routine translates ISCII/ASCII 7-bit code, and is 
designed to support Version 3 standards. The system forces OPTCD=Q during 
open to cause ISCII/ASCII translation during processing of any volume mounted 
as LABEL=AL. Note that, if the input data includes raw binary, floating point, 
or packed decimal fields, any bytes containing values that translate into more 
than 7 bits are converted to X’1A’, resulting in permanent loss of data. 


If necessary, you may replace the IBM-supplied translation routine, which is an x 
SVC routine, with an installation-written routine that translates ISCII/ASCII 8-bit K 2 
code. at 


Additional information on ISCII/ASCII 7-bit code and tables showing the relation- 
ship of EBCDIC, Hollerith punch code, and ISCII/ASCII 8-bit code is given in 
Appendix E, “Equivalent ISCI/ASCII, EBCDIC, and Hollerith Codes” on 

page 129. 


Volume Initialization 
Version 3 volumes are initialized with the IEHINITT utility program, or by the / 
operating system in the case of certain label conflicts during mount verification Ne? 
of a volume. Volume initialization is discussed under “Creating a Volume 
Label” on page 79. 


Version 3 Installation Exits 
Five installation exits are included in the system for Version 3 volumes: 


¢ WTOR exit for conversion from non-Version 3 to Version 3 labels, 
« Volume access, 

e File access, 

e Label validation, and 

¢ Label validation suppression. 


These exits are described in Appendix D, “Version 3 Installation Exits” on 
page 127. 
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RACHECK (RACF) Installation Exits 
~The RACHECK preprocessing and postprocessing installation exits can act on 
Version 3 volume accessibility and label validation. These exits are discussed 
under “Protecting Data” on page 64 and in Appendix D. 


Volume Protection 
Version 3 volumes can be protected by either RACF or the volume access exit. 
(See “Protecting Data” on page 64 and Appendix D.) 


Data Set Protection 
Version 3 data sets can be protected by the file access exit, data set password 
protection, or a RACF data set profile. (See “Protecting Data” on page 64 and 
Appendix D.) 


Label Validation 
Labels and program specifications for labels and file structure are checked to 
ensure that a tape format does not violate Version 3 standards. The label vali- 
dation exit is entered if any of the following requirements are not met: 


¢ Labels must contain only valid ISO/ANSI/FIPS characters. (For a list of the 
characters, see “Label Definition and Organization” on page 59.) 


e Label fields must contain properly aligned data. (For more information, see 
“Label Definition and Organization.”) 


¢ Labels that frame a data set must be symmetrical: 


— DISP=MOD is not allowed for extending an existing data set (however, 
it may be specified to create a new data set). 


— An open option for EXTEND, OUTINX, or INOUT is not allowed. 


_— An EXCP DCB used for output must contain at least a 4-word device 
dependent area. 


(For more information, see “Data Set Trailer Labels” on page 64, “Cre- 
ating a Volume Label” on page 79, and Data Facility Product: 
Customization.) 


e Block size must not exceed 2048 bytes. (See “Format of the Version 3 Data 
Set Label 2 (HDR2/EOV2/EOF2)” on page 95.) 


¢ Variable length records must be specified as Format-D, not as Format-V. 
Undefined-length records (Format-U) are allowed only for Version 1 input 
volumes; they are not allowed for Version 3 volumes. 


_¢ Duplicate data set names, including names for generation data sets, are not 
allowed on the same volume. (See “Processing the HDR1 Label” on 
page 72.). 


e Expiration dates for successive data sets on a volume must not be in 
ascending sequence. (See “Expiration Date on Existing Label” on page 83.) 
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Generation Data Groups 
For Version 3, generation and version numbers are not part of the data set 
name, as contained in the file identifier field of the HDR1 label. (See “Format of 
the Version 3 Data Set Label 1 (HDR1/EOV1/EOF1)” on page 89.) 


Spanned Records 
Spanned records (Format-S) are allowed and can be up to 16776192 bytes long; 
however, the actual length of logical records to be processed depends upon the 
amount of virtual storage that can be acquired. (See “Format of the Version 3 
Data Set Label 2 (HDR2/EOV2/EOF2)” on page 95 and Data Administration 
Guide.) : 


Block Padding | 

| A fixed-length logical record (Format-F) containing all ISCII/ASCII circumflex 
characters (X’5E’) will signal an end-of-block condition. A variable-length 
record (Format-D), beginning with a circumflex character, even though the rest 
of the record does not contain circumflex characters, will signal an end-of-block 
condition. 


Checkpoints 
7 Any ISCII/ASCII tape that is open during a CHKPT macro service will prevent a 
checkpoint from being taken. | 


Compatibility with Non-Version 3 Volumes 
For input, volumes with Version 1 labels are accepted, but without Version 3 
checking. Volumes with other than Version 1 or Version 3 labels are not 
accepted for input. | 


For output, all volumes will be written with Version 3 labels. A volume with 
Version 1 labels, or any other volume with an 80-character volume label con- 
taining the ISCII/ASCII characters VOL1 in the label identifier field, may be 
mounted for output, but only if the first data set is being written. (However, 
extending an existing data set, such as by specifying DISP=MOD in the DD 
statement, is not allowed.) The volume label is rewritten and the new header 
and trailer labels are written in Version 3 format. This converts the volume to 
Version 3. Note that this conversion requires intervention by the console oper- 
ator (in response to message IEC/04A during open/EOV, or IEC701D with the 
IEHINITT utility program). Therefore, with careful operational procedures, you 
can avoid creating an unexpected Version 3 volume. — | 


Processing Differences Between Version 1 and Version 3 


Version 3 processing for certain characteristics differs from Version 1 support. 
Because of these differences, job streams that run under Version 1 might fail or 
produce different results when run under Version 3. Therefore, Version 1 users 
should check their job streams and modify them, if necessary, before installing 
Version 3 support. 
The characteristics for which Version 3 processing differs from Version 1 are: 

e Label validation 


e Generation data groups 
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e Spanned records 
co e Block padding 
( « Checkpoints 


¢ Compatibility with non-Version 3 volumes 


Processing Version 3 Volumes on Earlier MVS Systems 


When a Version 3 volume is mounted on an earlier MVS system, the following 
restrictions apply: 


« Input generation data sets will not be recognized (because the .GxxxxVyy 
suffix is not part of a Version 3 file identifier). 


e Spanned record format will not be supported. 


« Data set characteristics recorded in the second header or trailer label of an 
i input volume will not be made known to the application program; instead, 
( they must be specified either in JCL or in the DCB. (This is because the 
Version 3 MVS system code, IBMZLA, Is not recognized by earlier systems.) 


e A data set having a header label created by a non-MVS system with a 1 or 
a 3 inthe accessibility field will be treated as an MVS password-protected 
data set, unless the volume is defined to RACF. 


« An uppercase letter from A through Z in the accessibility field of a header 
or volume label will cause the volume to be rejected. 


e Any output produced will not meet the specifications of Version 3 standards. 


Label Definition and Organization 


ISO/ANSI/FIPS labels are similar to IBM standard labels. The principal differ- 
ences are: 


e A maximum of 9 user volume labels can appear in the beginning-of-volume 


group. 
_ e An unlimited number of ISO/ANSI/FIPS user labels may be placed at the 
( ; beginning and end of a file, and they need not be sequentially numbered or 
lettered. 


* The formats of the ISO/ANSI/FIPS labels VOL1, HDR2, EOF2, and EOV2 are 
Slightly different from the formats of the corresponding IBM labels. 


e {SO/ANSI/FIPS labels HDR2, EOF2, and EOV2 are optional. These labels are 
required for IBM standard label tapes. 


« A maximum of 9 user EOF or EOV labels can appear in the file section label 
group. 
The labels must be recorded in the subset of ISCII/ASCII characters allowed by 
ISO/ANSI/FIPS standards. These characters are: 
e Uppercase alphabetic 


e Numeric 





* Space 


Chapter 3. ISO/ANSI/FIPS Labels 59 


« Special (specifically, !“%&'()* +,-./:;< = >?) 


All fields in Version 3 system labels (VOL1, HDR1, HDR2, EOV1, EOV2, EOF1, 





and EOF2) will be treated as containing meaningful data. This means alpha- ae 
meric fields (except “reserved for operating system” fields) will be left-justified, 

with unused positions filled with space characters; “reserved for future stand- 

ardization” fields will be filled with space characters; numeric fields will be 

right-justified, with unused positions filled with zeros. Date fields will have a 

leading space character. - 


The first four characters of an ISO/ANSI/FIPS tape label always identify the type 


of label: 


Label Identifier 


VOL1 


UVL1-UVLS | 


HDR1 
HDR2 


HDR3-HDRY 
EOV1 


EOV2 


EOV3-EOV9 


| ot 


EOF 1 


EOF2 


EOF3-EOF9 
UHLa?! 
UTLa? 


Label Definition 
Volume label 


User volume labels (optional; nof produced by MVS) 


Data set header label 1 oN 
Data set header label 2 (produced by MVS, but optional for aes 
input) 

Optional (not produced by MVS) 

End of volume trailer label 1 (produced by MVS, but optional 

for input) 

End of volume trailer label 2 (produced by MVS, but optional 

for input 

or input) es 
Optional (not produced by MVS) 3. 
End of data set trailer label 1 (produced by MVS, but 

optional for input) 

End of data set trailer label 2 (produced by MVS, but 

optional for input) 

Optional (not produced by MVS) 

User header labels (optional; unlimited number permitted) 

User trailer labels (optional; unlimited number permitted) ; : 


8 The fourth character of the user header and trailer labels may be any valid 


ISO/ANSI/FIPS character as defined above. 


Figure 11 on page 61 and Figure 12 on page 62 show the position of the labels 
with various tape volume organizations. User labels (URL, UTL) are optional. 
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( | Single Data Set/Single Volume: The volume label is followed by the data set header labels and optional user header labels. The 
data set is preceded and followed by a tapemark. The data set trailer labels are identified as EOF and followed by optional user 
trailer labels. Two tapemarks follow the trailer label group to indicate that the data set is the last data set on the volume and is 
not continued on another volume. 


Single Data Set/Multiple Volumes: More than one volume is needed to contain the data set. The last volume is organized the 
same as a single volume. On the other volumes the data set trailer labels are identified as EOV instead of EOF, and the trailer 


label group is followed by one tapemark instead of two. The data set and user labels are repeated on each volume and there is 
a separate volume label for each tape. 


Note: Shading indicates optional labels for ISO/ANSI labeled tapes. 


Figure 11. Volume Organization with ISO/ANSI/FIPS Labels (Single Data Set) 
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Multiple Data Sets/Single Volume: The tape begins with a volume label. Each data set is preceded by a header label group and 
a tapemark and is followed by a tapemark and a trailer label group. Each trailer label group is followed by a tapemark; the 
trailer label group for the last data set on the volume is follawed by two tapemarks. 


Multiple Data Sets/Multiple Volumes: More than one volume is needed to contain the multiple data set aggregate. The last 
volume is organized the same as a multiple data set/single volume layout. On the other volumes the data set trailer labels are 
identified as EOV instead of EOF, and the trailer label group is followed by two tapemarks. There is a separate volume label for 
each tape. 


Note: Shading indicates optional labels for {SO/ANSI labeled tapes. 





Figure 12. Volume Organization with ISO/ANSI/FIPS Labels (Multiple Data Sets) 
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Volume Label 








The volume label (VOL1) is the first record on an ISO/ANSI/FIPS labeled tape. 

It is at least 80 characters long. Although an ISO/ANSI/FIPS label can exceed a 
length of 80 bytes, the excess is not within the scope of the standards and will 
be truncated by MVS/XA. All Version 3 labels written by MVS/XA routines will 
be 80 bytes in length, including those in which an original label greater than 80 
bytes is rewritten (as in a density conflict). 


The volume label identifies the volume and its owner, and is used by data man- 
agement to verify that the correct volume is mounted. It also protects the 
volume from unauthorized use. 


Volume labels are created by the IEHINITT utility program, or by input from the 
operator during open when: 


e A label conflict is detected (a label conflict occurs when the type of label 
requested differs from the type of label read at load point from the mounted 
volume), or 


e The first block of a volume cannot be read (except a RACF-protected 
volume will be rejected if failure to read was because the tape format, such 
as a nonsupported density, was not recognizable by the control unit). 


For additional information about the IEHINITT utility program, see Utilities. 
User volume labels (UVL1-UVL9) are allowed, but not created or processed by 


MVS. They are checked only for valid label identification and correct 
sequencing. 


Data Set Header Labels 


ISO/ANSI/FIPS header labels consist of a data set label 1 (HDR1) and, in some 
cases, a data set label 2 (HDR2). The HDR1 label is created by the system rou- 
tines each time a data set is recorded on tape. A HDR1 label identifies and 
describes the data set and protects it from unauthorized use. 


The HDR1 label is at least 80 characters long, and any characters after position 
80 are not used for label checking and verification. 


A HDR2 label is optional for ISO/ANSI/FIPS labeled tapes. If present, it imme- 
diately follows the HDR1 label. The MVS operating system produces a HDR2 
label for output tapes; such a label on an input tape ts treated similarly to an 
IBM HDR2 label. If the HDR2 label is produced by another system, the 
“reserved for operating system” fields are not processed. 


User header labels (UHLa) are optional, and there is no limit to the number that 
can be associated with a data set. They must contain only valid ISO/ANSI/FIPS 
characters, but need not be sequentially numbered or lettered. 


Labels identified as HDR3-HDR9Y are allowed but are only checked for valid 
label identification and correct sequencing (and only if they are among the 
header labels of a requested data set). MVS does not create optional data set 
header labels beyond the second label. 
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Data Set Trailer Labels 


Tapemarks 


Protecting Data 


The data set trailer label 1 (EOV1, EOF1) is required for ISO/ANSI/FIPS labeled 
tapes. The standard EOV1 and EOF1 labels duplicate the standard HDR1 label 
so that the tape can be read backward. The EOV1 and EOF1 labels are iden- 
tical to a HDR1 label except that: 


¢ The identifier is EOV or EOF instead of HDR. 


¢ A block count is recorded in the first EOV1 or EOF1 label and is used on 
input to verify that all blocks of the data set are processed. The block count 
field in the HDR1 label contains zeros (which is what the EOF1/EOV1 block 
count is reduced to when the data set is read backward). 


Eighty-character Version 3 EOV1 and EOF1 labels are created by the system 
when the data set is recorded on tape. EOV1 and EOF1 labels created by 
non-MVS systems must be at least 80 characters long; any characters after 
position 80 are not used for checking or verification. 


Although they are optional for ISO/ANSI/FIPS labeled tapes, the EOV2 and EOF2 
labels are produced by the operating system. These labels are treated simi- 
larly to IBM EOV2 and EOF2 labels. If the EOV2 or EOF2 labels are produced by 
another system, the “reserved for operating system” fields are not processed. 


User trailer labels (UTLa) are optional, and there is no limit to the number that 
can be associated with a data set. They must contain only valid ISO/ANSI/FIPS 
characters, but need not be sequentially numbered or lettered. 


Labels identified as EOV3-EOV9 or EOF3-EOF9 are allowed but are checked only 
for valid label identification and correct sequencing (and only if they are among 
the trailer labels of a requested data set). The system does not create optional 
trailer labels beyond the second label. 


The tapemark requirements for ISO/ANSI/FIPS interchange tapes are: 


e Each header label group must be followed by a tapemark that indicates the 
beginning of the data to be processed. 


e Each data set must be followed by a tapemark that indicates the beginning 
of the trailer label group. 


* If the data set is the last one on the volume, each trailer label group. must 
be followed by two tapemarks. Otherwise, one tapemark Is required. 


When creating a data set with Version 3 labels, the system routines write the 
necessary tapemarks. 


The accessibility fields in the VOL1 and HDR1 labels indicate whether a volume 
and data set are protected against unauthorized use. Version 3 volumes can 
be protected by means of one of the following: 


© RACF. 
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e {BM-supplied Version 3 installation exits described in Appendix D, “Version 
3 Installation Exits” on page 127. (These can be replaced by installation- 
written exit routines.) 


e Data set password protection. 


¢ A combination of the installation exits and password protection. 


Version 1 input volumes are protected by either RACF or data set password 
protection. 


All checking for authorization will be bypassed if security processing is Sup- 
pressed. This can occur, for example, when the program properties table is 
marked to suppress security checking (for information about the program prop- 
erties table, see System Modifications). 


If a volume is RACF protected, ALTER access authority is required to create or 
destroy the VOL1 label, UPDATE access authority is required to open the 
volume for output (this includes reading and/or writing on the volume), and 
REAM access authority is required to open the volume for input. 


lf the tape volume is not defined to RACF, or if the tape volume is defined and 
the user is UPDATE authorized and PROTECT =YES has not been specified, 
processing continues. If the tape volume is defined and either the user is 
UPDATE authorized and PROTECT=YES has been specified, or the user is not 


~ UPDATE authorized, the volume will be rejected if a nonspecific request is 


made and the program will be abnormally terminated if a specific request is 
made. The operator will be requested to remove the write-enable (file protect) 
ring from a RACF-protected tape when a user with only READ authority 
attempts to process a tape for input. For an overview of RACF protection for 
tape volumes, see RACF General Information Manual. 


Data set password protection is described in System — Data Administration. 


Volume Accessibility 


Version 3 Volumes: lf the volume is RACF protected, and volume security proc- 
essing has not been suppressed, the RACHECK installation exits are entered to 
accept or reject the volume (by a return code from RACHECK). If the VOL1 
accessibility field contains an uppercase letter from A through Z, the RACHECK 
parameter list is initialized to address the Version 3 exit parameter list 


-(IECIEPRM) and the accessibility code. Otherwise, the RACHECK installation 


exits are passed zeroed pointers for the Version 3 parameters. If RACF accepts 
the volume but the Version 3 parameters to the exit were zero, the validation 


Suppression exit is entered. 


If RACF is not available, or the volume is not defined to RACF, OPEN/EOV 
checks the accessibility field in the VOL1 label. If the field contains an upper- 
case letter from A through Z, the volume access exit is entered to accept or 
reject the volume (by a return code in the exit parameter list). If the field con- 
tains a space, the validation suppression exit is entered. All other characters 
cause the volume to be rejected. 


The VOL1 accessibility code can be changed when the VOL1 label is changed 


by the IEHINITT utility, or by the operator during open (see “Volume Label” on 
page 63). 


Chapter 3. ISO/ANSI/FIPS Labels 65 


Version 1 Volumes: First, OPEN/EOV checks the accessibility field in the VOL1 
label. If the field contains a space character, the volume is defined to RACF, 
and volume security processing has not been suppressed, the RACHECK instal- 
lation exits are entered to accept or reject the volume (by a return code from 
RACHECK). If the field contains a space character, but the volume is not 
defined to RACF or volume security processing has been suppressed, access to 
the volume is allowed (however, as will be discussed below, each data set on 
the volume may be individually protected). If the field contains anything other 
than a space character, the volume is rejected. 


The VOL1 accessibility code can be changed when the VOL1 label is changed 
by the IEHINITT utility, or by the operator during open (see “Volume Label” on 
page 63). 


Data Set Accessibility 


lf a volume is RACF protected, and access to the volume was checked when the 
volume was verified (by RACHECK processing), data set accessibility fields will 
not be checked; therefore, any data set on the volume can be accessed. lf a 
volume is not RACF protected, data management inspects the accessibility field 
in the HDR1 label of the requested data set (for a multivolume data set, data 
management inspects the HDR1 label on each volume). The accessibility codes 
of any concatenated data sets are also inspected. 


Version 3 Volumes: A 1ora3 inthe data set accessibility field with a system 


code of “IBMZLA” indicates an MVS password-protected data set; a space char- 
acter in the accessibility field allows unlimited access; and an uppercase letter 
A through Z causes the file access exit to be entered for authorization proc- 
essing (the file access exit is also entered when a new data set is added to an 
output volume if the first character of the JCL ACCODE keyword is A through Z). 
Any other character causes the volume to be rejected. 


If the accessibility field of a data set being opened contains an A through Zora 
space, no attempt is made to check the accessibility field of any other data sets 
that may exist on the volume; therefore, the other data sets may be overlaid by 
new output. If accessibility checking for multiple data sets is required, it must 
be done by an installation-written file access exit. You should never place an 
access-protected data set on the same volume with unprotected data sets, 
because no exit is entered for unprotected data sets. 


An HDR1 accessibility code of A through Z can be specified by the ACCODE 
parameter of JCL. ACCODE can also be specified for dynamic allocation (SVC 
99 key). Changes to an HDR1 accessibility code of A through Z can be moni- 
tored by an installation-written file access exit. Password codes override 
ACCODE values if they are simultaneously specified. 


Version 1 Volumes: A 1ora3in the data set accessibility field indicates a 
password-protected data set. 


A space character in the accessibility field allows unlimited access, and no 
attempt is made to check the accessibility field of any other data sets that may 
exist on the volume; therefore, the other data sets may be overlaid by new 
output. 
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Input Processing for Password-Protected Data Sets 
7 For input processing of a password-protected data set, data management asks 
( : the operator or TSO user to enter the correct password. The password is veri- 
fied in a user-established password data set. This password data set contains 
the data set name, the password, and a protection-mode indicator. The data 
set name for Version 3 generation data sets does not include the .GxxxxVyy 
suffix. The protection-mode indicator is set to permit either read/write or read- 
only operations. Processing is terminated if: 


e The operator or TSO terminal user does not supply the correct password In 
two attempts. 


e The password record for the data set to be opened does not exist in the 
password data Set. 


System — Data Administration describes the protection feature and discusses 
how to create and maintain the password data set. 


( ~ Output Processing for Password-Protected Data Sets 
For output processing of a password-protected data set, data management 
compares the data set name shown in the HDR1 label with the data set name 
specified in the DD statement. For generation data sets on a Version 3 volume, 
the comparison of names does not include the generation and version numbers. 


If the names are not the same, processing is terminated unless the data set is 
the first one on the first or only volume. In this case, even if you specify a spe- 
cific volume, the operator will be requested to demount the tape and mount a 
= new scratch tape. If the names are the same, data management requests the 
{ : operator or TSO user to key in the required password. The password is verified 
| in a user-established password data set in the same manner as described 
above for an input data set. The read/write protection mode is necessary for 
output data sets. 


Two restraints are placed on creation of password-protected data sets: 


e When creating a password-protected data set following an existing 
password-protected data set, you must supply the password of the existing 
data set. The accessibility code of “1” or “3” must be the same in both the 

a existing and the new data set. This is true even if the volume has been 
( defined to RACF. 


e When creating a multivolume, password-protected data set, the second and 
successive volumes will also be verified. Verification consists of ensuring 
that the data set name in the JFCB (for Version 3 volumes, not including 
generation and version numbers, if present) is the same as the data set 
name in the password record and that the protection-mode indicator allows 
writing to the data set. i 


Deleting a Password-Protected Data Set: If a password-protected data set is 
deleted, the HDR1 accessibility field must be set to a space character before 
the volume can be written on again. This can be done by using either the 
IEHINITT utility or a user program to relabel the volume. 
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Overview of ISO/ANSI/FIPS Label Processing 


Label processing is handled by the /O support routines “et iaia management 
(open, EOV, and close). This processing consists of four basic functions: 


e Translating input labels from ISCII/ASCII to EBCDIC and translating Sutput 
labels from EBCDIC to ISCII/ASCIlI 


° Checking the labels on input tapes to 
— Ensure that the correct volume is mounted 
— Identify, describe, and protect the data set being processed 


— Attempt to ensure maximum correctness and consistency of data sets 
and their labels 


— Identify compatibility conflicts with Version 3 standards 
« Checking the existing labels on output tapes to 
— Ensure that the correct volume is mounted 
— Prevent overwriting of vital data 
— Identify compatibility conflicts with Version 3 standards 
« Creating and writing new labels on output tapes 
These processing functions are summarized in Figure 13 on page 69. The 


table shows the specific labels that are processed for each function and which 
routines perform the functions. 


Although the default of each of the IBM-supplied installation exits is to reject 
the volume, the exits may be modified to do additional label processing pase 
Appendix D, “Version 3 Installation Exits” on page 127). 


All volumes will be written with Version 3 labels. For information about using 
tapes with other than Version 3 labels, see “Compatibility with Non-Version 3 
Volumes” on page 358. 
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4 Operator must give Open/EOV permission to overwrite ULV labels. 


“User creates the label with the IEHINITT utility program or a user program. 








te Includes the first volume of concatenated data sets with like characteristics. 








( Figure 13. ISO/ANSI/FIPS Standard Label Processing by Data Management Routines 


Opening an Input Data Set 


When a data set is opened for input, the volume label, user volume labels, and 
data set header labels (data set trailer labels for read backward) are proc- 
essed. User header labels (user trailer labels for read backward) are also 
processed if they are present and the user has specified AUL in JCL. 


The tape device is checked for a density compatible with the density specified 
by the user, and the system is checked to ensure that the ASCII option was 
specified in the CTRLPROG macro at system generation time. 





Before verifying the volume, if the system-wide RACF tape protection option has 
been specified and the DD statement has specified PROTECT = YES without pre- 
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viously opening the DD statement for output processing, the program will be 
abnormally terminated. 


When the unit is ready to read the VOL1 label, the first record on the tape is WY 
checked for a length of at least 80 bytes and must contain the ISCIH/ASCII identi- 

fier VOL1 in the first 4 bytes. The volume label can be either Version 1 or 

Version 3. If the record is over 80 bytes long, the excess characters are 

ignored. 7 


After the VOL1 label is read, a work area is allocated to contain ISO/ANSI/FIPS 
data, such as the exit parameter list. Information from the VOL1 label is saved 
in the UCB class extension. 


Data management also checks for label conflicts (the type of label requested 
differs from the type of label read at load point from the mounted volume), com- 
patibility conflicts (the label is not Version 1 or Version 3), and density conflicts 
(the density specified by the user for the data set is not compatible with the 
density of the VOL1 label). In the case of a label conflict or version compat- 
ibility conflict, the volume is rejected. In the case of a density conflict, the 
density of the VOL1 label is used for all further processing of the data set. 


If system security checking should be bypassed, the validation Suppression exit 
is entered. Otherwise, if the system-wide RACE tape protection option has 
been specified, RACF access authorization to the volume is checked for READ 
authority. If a tape with Version 3 labels is not RACF protected and the VOL1 
accessibility field contains an uppercase letter from A through Z, the volume 
access exit is entered. For more details of RACF and accessibility checking, 
see “Protecting Data” on page 64. 


For a tape with Version 3 labels, after access to the volume is authorized, the 
request is checked for possible symmetry violations. Because INOUT can result 
in asymmetrical labels, specifying this option will cause the label validation exit 
to be entered (unless validation has been suppressed). In addition, unless vali- 
dation has been suppressed, the VOL1 label is checked for conditions not 
allowed by Version 3 standards. If an invalid condition is found, the label vali- 
dation exit is entered. 


Volume Serial Number 
Data management uses the VOL1 label to ensure that the correct tape is 
mounted. The volume serial number in the label is compared to the volume 
serial number you specify. You can specify the serial number either directly in 
the DD statement or indirectly through the catalog facility. Serial numbers are 
required when the processing method is INPUT or ROBACK. 


lf the volume serial number is correct, the volume is considered to be mounted 
and verified. If the serial number is not correct, data management rejects the 
tape and issues another mount message. 





70 MVS/XA Magnetic Tape Labels and File Structure Administration 














Positioning the Volume to the Data Set 
ie When the volume is mounted and verified, data management positions the tape 
( to the front of the header label group of the data set to be processed. Usually, 
there is only one data set on the reel, and the header label group immediately 
follows the volume label. 


Unless the data set is cataloged, you specify a data set sequence number in the 
LABEL parameter of the DD statement to retrieve a data set when more than 
one data set is on a single reel of tape. You need not specify a data set 
sequence number for a cataloged data set, because the number can be | 
obtained from the catalog along with the volume serial number. | 





The sequence number can be from 1 to 9999, with 1 representing the first data 
set on the volume. If you specify a sequence number higher than the number 
of data sets on the volume, your task will be abnormally terminated or, if the 

volume ends with EOV labels, the open routine will switch to the next volume. 


( | If the data set is not cataloged and you do not specify a sequence number, or 
you specify 0, data management assumes that the data set is the first in 
sequence on the volume. | 


To position the tape, data management uses the requested data set sequence 
number shown in the JFCB and the data set sequence number shown in the 
first HDR1 label on the tape, and maintains a logical data set sequence number 
in the UCB. The number in the UCB represents the current position of the tape, 
and is maintained as follows: 


( 1. When a tape is first mounted, the data set sequence number in the UCB is 
| 0. 


2. When a data set is opened, the open routine sets the data set sequence 
number in the UCB to 1. The exceptions are: 


¢ If the tape is still positioned from previous processing, such as for a 
LEAVE request, the open routine does not reset the number in the UCB. 


¢ If the data set sequence number in the JFCB and the data set sequence 
number in the first HDR1 label on the tape are both greater than 1, the 
co open routine sets the data set sequence number in the UCB to the 
( value of the number in the first HDR1 label. (The data set sequence 
number in the first HDR1 label may be greater than 1 when the volume 
is part of a multiple data set/multiple volume aggregate.) 


e When the processing method is input to the start of a data set on a mul- 
tiple file tape, the open routine starts with the first value, unless a 
volume sequence number is specified. If the volume ends with EOV 
labels before the desired file sequence number, the open routine will 
switch to the next volume and permanently update the volume 
sequence number so that the next open to this data set will start with 
the correct volume. 


e When the processing method is RDBACK, the open routine speeds up 
finding the end of the data set by starting with the last volume specified. 
lf the data set is not yet present on the last volume specified, and if the 
file sequence number is 1, the open routine can recover by backing up 
volumes. It detects that the data set is not present if the dsname is 
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invalid, the tape starts at a file sequence number greater than 1, or the 
VOL label is followed by a tapemark. ae 


3. The data set sequence number in the UCB is compared to the requested eY 
data set sequence number in the JFCB. If they are equal, the tape is 
already positioned at the requested data set. If they are not equal, the 
open routine adjusts the data set sequence number in the UCB as the tape 
is positioned past each data set, until the number in the UCB equals the 
number in the JFCB. 


4. When multiple tape units are used and a volume switch causes processing 
to be continued on a volume on a different unit, the EOV routine copies the 
data set sequence number from the previous UCB to the current UCB. 


5. If the data set is not open or has been closed, the UCBFSCT field of the 
UCB will be set to X’0000’ if: 


* The data set was never opened or, 
¢ CLOSE (,REWIND) was specified or, a, 
¢ CLOSE (,REREAD) and LABEL =1 was specified or, | 


« CLOSE (,DISP) was specified or defaulted, and DISP={,PASS) was not 
specified on the JCL. 


Otherwise, the UCBFSCT field of the UCB will have a value one greater than 
the value specified on the LABEL parameter of the JCL. 


6. If the job abends while a tape data set is open, the data set will be closed 
and the tape will be positioned as when CLOSE (,LEAVE) Is specified. That 
is, the UCBFSCT field of the UCB will have a value one greater than that | 
specified on the LABEL= parameter of the JCL. So 


There are several instances in which a volume is repositioned to the next (or 
previous) tapemark during open. This is usually done by reading data but sup- 
pressing data transmission to storage until a tapemark is found, but can be 
done by I/O spacing commands (for example, BACKSPACE FILE). To reduce 
the chance of an “unexpected record” condition (613-O0C), the first method is 
preferred over the spacing commands. In the event of a 613-08 or 613-0C 
abend, a tape positioning installation exit (IFGO1991) will be given control to 
allow recovery. For more information about the “data management abend 
installation” exit, see Data Facility Product: Customization. aie 


Only one data set on a tape volume may be open at any given time. An 
attempt to begin processing of a second data set on the same volume results in 
abnormal termination. 


When the tape is positioned to the data set header label group of the first data 
set, or the requested data set, data management checks the label identification. 
If the identifier HDR1 is not found, processing is abnormally terminated. 


Processing the HDR1 Label 
To ensure that the correct data set is being opened, data management com- 
pares the file identifier field in the HDR1 label of the requested data set to the 
data set name specified in the DD statement. If the comparison shows an 
incorrect data set name, processing is abnormally terminated. 
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The comparison is made on only the last (rightmost) 17 nonblank characters of 
the data set name shown in the HDR1 label. It is a good practice, therefore, to 
limit tape data set names to 17 characters or fewer, when unique names are 
required, as for password-protected data sets. 


For Version 1 HDR1 labels, the generation and version numbers of a generation 
data set are included in the file identifier, and thus are included in the charac- 
ters compared by data management; however, for Version 3 HDR1 labels, they 
are not included in the file identifier. For generation data sets with Version 3 
labels, the generation and version numbers do not participate in password pro- 
tection. 


For tapes with Version 3 labels, during positioning, the file identifier in each 
HDR1 label encountered is also checked to ensure against duplicate names for 
the requested data set. The duplicate name check occurs only from the volume 
position at the time of OPEN until the destination position. For example, ifa 
volume is positioned at the end of data set “X’ at position 5 on the volume as a 
result of a previous CLOSE LEAVE request, and you request that a data set ‘Y’ 
be opened at position 6, no duplicate name check will occur, because the 
volume is already at the desired position. You can force a subsequent dupli- 
cate name check from the beginning of the volume by using the CLOSE REWIND 
option. 


lf a request is for the first data set on a volume, the volume is always rewound 
to load point, and no duplicate name search occurs. 


You can force a duplicate name check from the first volume of a multivolume 
configuration by specifying a volume sequence number of 1 (VOL=(PRIVATE,,1) 
along with a cataloged data set request or along with serial numbers specified. 
During the search, the message !EC140I START OF DATASET NOT ON VOLUME 
will occur for each volume mounted on which the requested data set is not 
found. 


Because the suffix of a generation data set is not included in the file identifier of 
a Version 3 HDR1 label, duplicate name checking prohibits maintaining 
members of the same generation data group on a volume (unless label vali- 
dation has been suppressed). 


If a duplicate name is encountered, the label validation exit is entered. Note, 
however, that, if you inadvertently specify an incorrect file sequence number for 
a data set, and the data set is encountered before the number specified, the 
exit will be entered with a “duplicate name error’ condition. If the exit accepts 
the error, an abend may result when the target data set does not match the 
requested data set name. 


For tapes with Version 3 labels, the accessibility field in the HDR1 label is also 
checked if the volume is not RACF protected. If it contains an uppercase letter 
from A through Z, the file access exit is entered. (For more details about 
accessibility, see “Protecting Data” on page 64.) 


The expiration date shown in the HDR1 label is not verified for input data sets, 
except to check the field in a Version 3 label for valid format. 
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The block count shown in the HDR1 label is always an ISCII/ASCII 0. This 0 is 
recorded in the DCB and increased during processing for comparison to the 


block count shown in the trailer label (EOV1 or EOF‘). a 
| 7 
For reading backward, the block count shown in the trailer label (EOV1 or EOF1) 
is recorded in the DCB and decreased during processing for comparison to the 
O block count in the HDR1 label. 
The block count is verified at end of data set or end of volume. 
a OS 





74 ~MVS/XA Magnetic Tape Labels and File Structure Administration 




















Processing the HDR2 Label 


Because the HDR2 label is optional with ISCII/ASCII interchange tapes, and 
because the HDR2 format may vary if produced by systems other than MVS, the 
manner of processing HDR2 labels depends on whether the HDR1 label speci- 
fies "IBMZLA” as the name of the system producing the tape. If ”“IBMZLA” is 
specified, the HDR2 label “Reserved for Operating System” field contains the 
same data as an IBM standard HDR2 label, and is processed accordingly {see 
“Data Set Characteristics” on page 22). If "IBMZLA” is not specified, the data 
in the HDR2 label “Reserved for Operating System” and “Record Format” fields 
cannot be used by the operating system because the contents are unknown. 


Unless user header labels are to be processed, data management reads 
forward until a tapemark is found. All labels that follow the HDR2 label are 
checked for proper sequence until the tape is positioned at the first data set 
record (unless validation checking has been suppressed). This includes the 
optional HDR3-HDR3$9 labels. 


Processing User Header Labels 


Read Backward 


To make the user header labels available to your program, AUL must be coded 
on the DD statement and the address of an input user header label routine 
must be specified in the DCB exit list (EXLST). (The DCB exit list (EXLST) is 
described in Data Facility Product: Customization.) If you omit one of these 
parameters, data management positions the tape past the tapemark imme- 
diately after processing the HDR2 label, or the HDR1 label if the HDR2 label is 
not present. 


For the read backward (RDBACK) processing method, data management uses 
the data set’s trailer labels as header labels, and vice versa. Each label group 
is read in the normal sequence, that is, EOF1 before EOF2, and so forth. The 
data records, however, are read in reverse sequence. 


Multivolume data sets can be read backward. Concatenated data sets, 
Format-D (variable-length) records, and Format-S (spanned-length) records 
cannot be read backward. 


End-of-Data or End-of-Volume on Input 


Data management’s EOV routine handles both end-of-data-set and end-of- 
volume conditions on input. These conditions occur when: 


e A tapemark is read. 
e An FEOV (force-end-of-volume) macro instruction is executed by the proc- 


essing program. 


After encountering a tapemark, data management checks the first 4 bytes of the 
first trailer label for the identifier EOV1 or EOF1. If neither identifier is found, 
processing is abnormally terminated. 


For an end-of-data condition, the first trailer label is processed, unless deferred 


user input trailer label processing is specified in the DCB exit list. For an end- 
of-volume condition, the first trailer label on the current volume is processed, 
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and then the volume label and header labels on the next volume are proc- 
essed. 





Except when it is used as a header label for a read backward operation 
(RDBACK), data management ignores the second trailer label (EOQV2 or EOF2) 
of an input data set. 


Uniess the tape is read backward and the trailer labels are used as header 
labels, trailer labels are not validated for Version 3 standards. 


When the FEOV macro instruction is issued, the identifier of the first trailer label 
is not checked. The trailer labels on the current volume are not processed, but 
the volume labels and header labels on the next volume are processed. 


If user trailer labels (UTL) are present on input, data management can make 

them available to your program. To make them available, AUL must be coded 
on the DD statement and the address of an input user trailer label routine must = 
be specified in the DCB exit list. — 


Verifying Block Count 
To verify that all records on the input data set on the current volume have been 
read, data management compares the block count shown in the first trailer 
label (EOV1 or EOF1) against the block count that was accumulated in the DCB. 
For reading backward, data management compares the 0 block count shown in 
the HDR1 label against the block count in the DCB. 


If the block count in the label does not equal the block count in the DCB, the — 
EOV routine gives control to the appropriate entry in the user’s DCB exit list. a: 
This entry in the exit list is identified by the code OB (hexadecimal). The EOV 

routine passes the following information to the exit routine: 


Register Contents 

0 The block count shown in the label 

1 The address of the DCB 
e ’ 
Meee 
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After your exit routine analyzes the discrepancy (and possibly prints a 
message), your exit routine must return to the EOV routine with one of the fol- 


( | lowing return codes in register 15: 
Return 
Code Meaning 
0 Abnormally terminate with completion code 237 
4 Continue processing 


If you do not provide the appropriate user exit entry in the DCB exit list, a block 
count discrepancy causes processing to abnormally terminate with a com- 
pletion code of 237. 


When the FEOV macro instruction is executed, the block count is not verified. 


Determining Volume Switch 
< For a multivolume input data set, you must specify the serial numbers of all the 
( volumes to be processed. The serial numbers are specified either directly in 
the DD statement or indirectly through the catalog procedure. You specify the 
serial numbers in forward sequence, regardless of whether the tapes are to be 
read forward or backward. 


¢ For noncataloged data sets, you specify the volume serial numbers in the 
VOLUME parameter of the DD statement. Data management processes the 
group of volumes in whatever order you specify and processes only the 
volumes you specify. 


( - ¢ For cataloged data sets, the group of volumes must be processed in 

| sequential order. However, you can begin processing at any volume of the 
group by specifying a volume sequence number in the VOLUME parameter 
of the DD statement. 


For input, the label identifier of the trailer labels determines whether data man- 
agement continues processing the data set. When data management finds an 
EOV label, it performs volume switching. When data management finds an EOF 
label, it passes control] to the user’s end-of-data routine, with one exception: If 
the DD statement specifies OPTCD=B, data management performs volume 


( : switching. 


To determine whether additional volumes are required, data management 
maintains a volume sequence number in the data extent block (DEB) in storage. 


e For read forward operations, the volume sequence number in the DEB is 
increased as each volume is processed. This count is compared to the 
total number of volumes requested, as shown in the JFCB. 


e For read backward operations, the volume sequence number in the DEB is 
initialized to the total number of volumes requested, as shown in the JFCB. 
The DEB count is decreased as each volume is processed, until the count 
reaches 0. 


If another volume is not required (end-of-data-set condition), control is given to 
the user’s end-of-data-set routine that is specified in the DCB. Subsequently, 
the processing program or the operating system closes the data set. The 
user’s end-of-data-set routine is not entered until the last specified volume or 
the last concatenated data set is processed. If an input data set is closed 
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before the end of the data set is reached, the user’s end-of-data-set routine is 
notentered, : 


If another volume is required (end-of-volume condition), data management aa 
obtains the next volume serial number from the JFCB and performs volume 

switching. If the new volume is not already mounted, the EOV routine issues a 

mount message to the operator. 


When multiple tape units are being used, the EOV routine also checks to see if 
there is a next-plus-one volume specified, and if the volume just completed can 
be rewound and unloaded. If so, the EOV routine issues a message directing 
the operator to mount the next-plus-one volume on the tape unit just used. This 
is a premounting aid; the next-plus-one volume label is not verified at this time. 


Checking the Next Volume | 
When volume switching is performed for multiple volume input, the EOV routine 
checks the volume and header labels on the new volume. oe 


The VOL1 label is checked as if it were the first volume of the group; that is, the 
volume serial number is verified to ensure that the correct volume is mounted. 
Volume accessibility and data set accessibility are also checked as if it were 
the first volume of the group. | 


lf a new concatenated data set is not processed and the open its for OUTIN, it 
will be further verified that, if the new volume is RACF defined, it is defined as 
part of the same volume Set profile as the previous volume. 


The method of locating and checking the HDR1 label varies according to the 
situation. The processing depends on whether the data set is a continuation of 
a multivolume data set or is a concatenated data set with like characteristics. 
(Data sets with like characteristics can be processed correctly using the same 
DCB, input/output block (IOB), and channel program.) 


e Multivolume data set: The data set sequence number !s irrelevant for the 
second and subsequent volumes of a multivolume data set. The EOV 
routine assumes that the data set continues at the beginning of the new 
volume and, therefore, checks the first header label group on the tape. The . 
HDR1 label is checked in the same manner as when the data set was ( 
opened on the first volume. Nd 


¢ Concatenated data sets: The EOV routine handles concatenated data sets 
with like characteristics. Such data sets are not necessarily the first on the 
volume, so the EOV routine positions the tape according to the specified 
data set sequence number. This positioning is the same as for opening a 
data set. The HDR1 label is checked as it was when the first data set was 
opened. 


The HDR2 label on the new volume is not processed. The data set character- 
istics that were established when the data set was opened apply to all subse- 
quent volumes handled by the EOV routine. However, the HDR2 label is 
validated for Version 3 standards. 


The data set’s block count is not accumulated from volume to volume. It is ini- £~ 
tialized and verified separately for each volume. « 
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Closing an Input Data Set 


( - The close routine does not process trailer labels on an input data set. Usually, 
the trailer labels are processed by the EOV routine before the data set is closed 
unless deferred user input trailer label processing was specified in the DCB exit 
list. If deferred user input trailer label processing was specified, the processing 
otherwise performed for an input end-of-data condition is performed when an 
input data set is closed. 


lf an input data set is closed before it reaches the end of data set or the end of 
volume, or if the FEOV macro instruction is executed, processing of trailer 
labels is not performed. 


Creating a Volume Label 


The VOL1 label is usually created by the IEHINITT utility program or a user’s 
ae program when the reel of tape is first received at the installation. At that time, 
( a permanent volume serial number is assigned to the reel, physically posted on 

the reel, and recorded in the VOL1 label. 


The IBM-supplied utility program IEHINITT writes the following labels in 
ISCII/ASCII code: 


1. A VOL1 label with the volume serial number, accessibility code, and owner 
identification that you specify. You cannot specify any other fields of the 


VOL1 label. 
fc. 2. Adummy HDR’1 label with ‘0001’ in the file section number, file sequence 
number, and generation number fields; "IBMZLA” in the system code field; 


and a space in the accessibility field (allowing unlimited access). Reserved 
fields will contain zeros, with a leading space in the date fields. 


3. A tapemark. 


A tape initialized with these labels should not be confused with an 
ISO/ANSI/FIPS tape, which requires at least one data set (the data set can be 


empty). 


( Version 3 standards require label symmetry around an empty data set when a 
: volume is initialized. The labels written by IEHINITT are accepted by data man- 

agement routines, which, in turn, produce symmetrical labels; the HDR1 label ts 
updated with system data, the single tapemark is overwritten with a HDR2 label 
containing data set characteristics, and a tapemark is written to complete the 
beginning-of-volume and beginning-of-file label groups. Whether or not any 
data is written in the data set, a set of trailer labels is written when the data set 
is closed. 
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The IEHINITT utility program can write a VOL1 label on a labeled, unlabeled, or 
blank tape: it makes no checks to see what data, if any, exists on the tape. 
Therefore, IEHINITT does not check for password or RACF security protection; it | 
does not create, modify, or delete RACF profiles of RACF-defined volumes. S7 
Detailed procedures for using the program are described in Utilities. 


Methods other than the IEHINITT utility program can be used to write VOL1 

labels. You can use a card-to-tape program, or you can replace the 

IBM-supplied volume label editor routine (see Chapter 6, “Volume Label Verifi- 

cation and Volume Label Editor Routines” on page 113) with one that writes 

VOL1 labels. Some data or a tapemark should already exist on the tape; other- 

wise, the tape control unit may read through the entire reel of blank tape 
looking for some data. | 


: Except for the IBM 3480 Tape Subsystem (with or without Improved Data 
Recording Capability) the VOL1 label is rewritten by the open or EOV routines if 
all the following conditions are met: 


« A density conflict has occurred. 

e OUTPUT or OUTIN is specified in the OPEN macro instruction. 
e The tape is sosnioned to the first data set on the volume. 

¢ Either of the following two conditions are true: 


— The data set is not password protected, or | 
— The volume is RACF protected, the system-wide RACF tape protection 
option has been specified, and the user is ALTER authorized. 


* The volume does not have UVL labels. If it does, the operator must give 
permission to rewrite the VOL1 label because the UVL labels will be over- 
written. | : 


On an IBM 3480 Magnetic Tape Subsystem (with or without Improved Data 
Recording Capability) the open and EOV modules bypass rewriting a VOL1 
label. 


If you request output to the first data set on an ISO/ANSI/FIPS output volume 
(AL, AUL) and the tape that you are allocated is recorded in the wrong density 
and cannot be read, the open or EQV routine rewrites the VOL1 label in the 
density you specify. 


This allows you to make nonspecific requests for output tapes (that is, you need 
not specify a volume serial number in your DD statement) and allows the oper- 
_ator to mount any available scratch tape to satisfy your request. However, if 
the system-wide RACF tape protection option has been specified, the volume is 
rejected, because it cannot be verified that it is not a RACF-protected volume. 


If you request output to other than the first data set on the volume and a density 
conflict occurs, all further processing is done in the density of the existing VOL1 
label (unless the IBM-supplied volume label editor routines are replaced with 
installation-written routines that do otherwise; note, however, that, if the densi- 
ties are mixed, the tape will not meet the specifications of Version 3 standards). 





If you make an output volume request for an ISO/ANSI/FIPS labeled (AL, AUL) 
tape and the mounted volume is an NL, NSL, SL, or SUL labeled tape, the open 
or EOV routine will create a VOL1 label only after checking authorization for 
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access, Checking the expiration date, and sending a message to the console 
operator requesting serial number and owner information (see Figure 14 on 
page 8/7, Fields 3 and 7). | | 


Opening an Output Data Set 


When a data set is opened for output, processing is similar to that of opening 
for input. The exceptions are: 


¢ Only Version 3 tapes are created for output processing. 


e If the system-wide RACF tape protection option has been specified and the 
DD statement has specified PROTECT = YES, and the DD statement has not 
previously been opened for output processing, OPEN ensures the 
PROTECT = YES specification is valid; both the volume sequence number 
and the file sequence number must be set to one and a private volume 
must be requested. The protection indicator in the JFCB is reset so that 
subsequent OPENs of that DD statement for output processing will not 
attempt validity checking (of the PROTECT =YES specification) and defi- 
nition of the volume to RACF. 


e The volume label editor is entered for label conflicts. The volume label 
editor is also entered for version conflicts (the label is not Version 3) if 
output is to the first data set; if output is to any other than the first data set 
or if the first data set is allowed to be extended, a version compatibility con- 


flict will cause the volume to be rejected. 


e An action message Is issued to the operator if the tape is file protected (to 
allow writing). 


e If the system-wide RACF tape protection option has been specified, RACF 
authorization at the UPDATE level is checked. If a Version 3 tape is not 
RACF protected, the volume accessibility code is checked as it is for input 
processing. For additional information, see “Protecting Data” on page 64. 


¢ Symmetry violations during output to a Version 3 volume will occur if the 
open option is EXTEND or OUTINX. Open for MOD during output also vio- 
lates symmetry, and is checked after the volume has been positioned. An 
EXCP DCB will be checked to ensure the presence of a device-dependent 
area large enough to contain a block count. 


If a density conflict occurs, the volume label editor is entered. If the conflict 
occurs for the first data set on the volume, a new volume label (Version 3) is 
written in the density specified by the user. For other than the first data set, the 
volume label is written in the density of the volume label at the beginning of the 
tape, unless the volume label editor is modified. If the old volume label is 
longer than 80 characters, the excess characters are lost unless: 


« The IBM-supplied volume label editor is replaced with a program that pro- 
tects the extra data during a density conflict before returning to open/EOV 
for reverification of the volume, or 


¢ The operator rejects a rewrite of the label by a response to message 
“IEC704A L” or “IEC704 L UVL”. 


New header labels are written after the volume label Is rewritten. 
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Volume Serial Number | 
You need not specify a volume serial number for output tapes. If none is speci- ff 
fied, the mount message directs the operator to mount a scratch tape. Data \ 
management gets the volume serial number from the VOL1 label and records it 
in the JFCB and UCB. | | R 


If you choose to specify the volume serial number, data management compares 
it with the volume serial number shown in the VOL1 label. If the number is 
correct, data management resets a mount switch in the UCB to indicate that 
volume mounting is verified (the switch is initially set when the mount message 
is issued to the operator). If the volume serial number is incorrect, data man- 
agement may give the operator the option of having the label rewritten with the 
serial number of the volume requested. This will occur if the tape is not pass- 
word protected, is not date protected, and is not a checkpoint/restart volume. 
Otherwise, data management rejects the tape and issues another mount 
message. | 


Positioning the Volume to the Data Set Se 
When the volume is mounted and verified, data management positions the tape 
to receive the new data set. Usually, the new data set is the first and only data 
set on the tape, so the tape remains positioned immediately following the VOL1 
label. 


To create a data set that follows another data set already stored on the tape, 
you specify a data set sequence number in the LABEL parameter of the DD 
statement. 


e The sequence number can be from 1 to 9999, with 1 representing the first ae, 
data set on the volume. If the volume ends with EOV labels before the 7 
specified sequence number, the open routine will switch to the next volume. 

If you specify a sequence number that is greater than the number of data 
sets existing on the volume, plus one, your task will be abnormally termi- 
nated. For any label validation errors encountered beyond the 254th data 
set, the error message will not include the explicit sequence number; 
instead, it will indicate “254+”. 


e If you do not specify a sequence number, or if you specify 0, data manage- 
ment assumes that the data set is to be written as the first one on the | 
volume. ae, 


To position the tape, data management maintains a logical data set sequence 
number in the UCB. The method of positioning is the same as that previously 
explained for opening an input data set. 


Only one data set on a tape volume can be open at any given time. If you 
attempt to open another data set on the same volume, processing is abnor- 
mally terminated. This restriction includes system output (SYSOUT) tapes. 


When the tape is positioned to receive the new data set, data management 
expects to find either an existing HDR1 label or a tapemark. If neither is 
present, data management assumes that other data is recorded where the 
HDR1 label should be and, therefore, processing is abnormally terminated. (If 
the last data set on a tape has EOV labels, another data set cannot be written 
to follow it.) 
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If a tapemark is found, it indicates that a HDR1 label does not exist at the posi- 

— tion at which the new data set is to be written. Data management bypasses all 

( further label verification and accepts the tape for output. The conditions under 
which data management finds a tapemark instead of a HDR1 label are: 


e When a tapemark immediately follows the VOL1 label. This may occur 
when the tape is initialized by means other than the IEHINITT utility 
program (IEHINITT writes a dummy HDR1 label following the VOL1 label). 
The tapemark is overwritten by the new HDR‘1 label. 





e When, for multiple data set organizations, the new data set is to be written 
after the last existing data set on the volume. In this case, data manage- 
ment encounters the second tapemark following the existing EOF trailer 
label group. The tapemark is overwritten by the new HDR1 label. 


Duplicate data set names are checked for Version 3 volumes during positioning, 
as described under “Opening an Input Data Set” on page 69. 


( : If a volume is not RACF protected, the accessibility code in the existing HDR1 
label of a Version 3 volume is checked before it is overwritten with a new HDR1 
label. 


Expiration Date on Existing Label 
For a volume with multiple data sets, data management checks the expiration 
date of the data set that immediately precedes the output data set. If the pre- 
vious data set’s expiration date is later than the expiration date of the output 
data set, the label validation exit is entered, unless label validation has been 


( 7 suppressed. 


If the previous data set’s expiration date is equal to or greater than that of the 
output data set, the expiration date of the output data set is compared with the 
current date. If the expiration date of the output data set has not been reached, 
the operator is asked to confirm use of the tape or to mount another tape. 


Any data sets following the output data set are treated as if they expired on the 
same day as the output data set. 


( Writing Data Set Header Labels 
When the tape is accepted by data management for output, data management 
creates the header labels (HDR1 and HDR2) for the new data set. These labels 
are created from information in the updated JFCB and other system control 
blocks. 


The source of information for each field of a label is explained in the description 
of label formats. The process of updating the JFCB is explained in Chapter 1, 
“Introduction to Tape Processing” on page 1. 


If no user header labels are to be written, data management writes a tapemark 
after the HDR2 label. The tape is then ready to receive the new data set. 
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meg: User Header Labels 
For data management to write user header labels (UHL), you must code AUL on 
the DD statement and specify the address of an output user header label o : 
routine in the DCB exit list (EXLST). The DCB exit list (EXLST) IS described in _ 
Data Facility Product: Customization. | 


Unless label validation has been suppressed, the user header labels will be val- 
idated to ensure they contain valid ISO/ANSI/FIPS characters. Violations will 
cause the label validation exit to be entered. 


User header labels do not have to be sequentially numbered or lettered. There 
is no limit to the number that can be associated with a data set. 


Permanent I/O Error | 
In some cases, if a permanent I/O error occurs during label processing, and the 
data set is the first one on the first or only volume, the operator will be 
requested to demount the tape and mount a scratch tape, even if you request a a 
specific volume. If the data set is not the first one on the volume or this is not 
the first volume of a multivolume data set, the job will be abnormally termi- 
nated. 


End-of-Volume on Output 


The data management EOV routine automatically switches volumes when an 
end-of-volume condition occurs, that is, when a reflective strip is encountered 
or a FEOV macro instruction is executed. This volume switching includes: 


e Writing trailer labels on the current volume | ea 
* Checking existing volume and header labels on the new volume 
e In the case of a density conflict, writing a volume label on the new volume 


e Writing header labels on the new volume 


In the case of a density conflict when the volume label is checked, a new label 

(Version 3) is written in the density specified by the user. If any user volume 

labels (UVLs) exist, they will be overwritten. If the original volume label is eo 
longer than 80 characters, the excess characters are truncated when the new 
volume label is written. 


When multiple tape units are being used, the EOV routine also checks to See if 
a next-plus-one volume is needed, and if the volume just written can be 
rewound and unloaded. If so, the EOV routine issues a message directing the 
operator to mount the next-plus-one volume on the tape unit just used. This is 
a premounting aid; the next-plus-one volume label is not verified at this time. 


Writing Data Set Trailer Labels 
Trailer labels are always written at an end-of-volume condition on output tapes 
and are identified as EOV1 and EOV2 (as opposed to EOF for end of data). 
These labels are created in the same manner and with the same content as the 
data set header labels, except for the label identifiers and the block count. 


satan 


84 MVS/XA Magnetic Tape Labels and File Structure Administration 











At end of volume, two tapemarks are written following the data set trailer 
labels. If user trailer labels are to be written, the tapemarks follow the user 
labels. 


Writing User Trailer Labels 


When AUL is coded on the DD statement and the address of an output user 
trailer label routine is specified in the DCB exit list, data management can write 
as many user trailer labels as desired. 


The contents of user trailer labels are not checked during EOV processing, but, 
if they contain any invalid ISO/ANSI/FIPS characters, the condition will be 
detected during a subsequent open for RDBACK. 


Labels on New Volume 


The EOV routine handles label processing on the new volume (checking 
existing labels and writing new labels). The processing is the same as the 
open routine’s handling of the first volume. 


When creating a multivolume data set, the data set sequence number is irrel- 
evant for the second and subsequent volumes. The EOV routine assumes that 
the data set continues at the beginning of the new volume. 


RACF Processing on the New Volume 


If the system-wide RACF tape protection option has been specified, RACF 
authorization checking will occur for the new volume. If the previous volume is 
RACF protected, the new volume must either be not defined to RACF (in which 
case, EOV will define it to RACF as part of the previous volume’s volume set 
profile), or the new volume must be defined as part of the same volume set 
profile as the previous volume. If the previous volume is not RACF protected, 
the new volume will be rejected if a nonspecific request is made, or the 
program will be abnormally terminated if a specific request is made. 


For tapes with Version 3 labels, the volume access exit is entered if the new 
volume is not RACF protected and the accessibility field in the VOL1 label con- 
tains an uppercase letter from A through Z. 


Special End-of-Volume Conditions 


When a reflective strip causes an end-of-volume condition during the writing of 
data, the EOV routine writes the trailer labels as described above. If the reflec- 
tive strip is encountered while writing the trailer labels, the EOV or the close 
routine continues to write the trailer labels. In both cases, the data set can be 
read or overwritten normally, even though it crosses the reflective strip. 


If you add another data set to a tape (multiple data set organization) on which 
the last existing trailer label group crossed the reflective strip, or on which the 
new header label group crosses the reflective strip, data management: 


e Writes the new header label group 
e Allows the user to write one record 
e Writes the new trailer label group 


e Performs volume switching 
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Closing an Output Data Set 


The close routine handles end-of-data-set processing on output tapes. When a 
write operation es the last operation that occurs before closing a data set (for 
OUTPUT or OUTIN) or when no output is written before closing (for OUTPUT or 
OUTIN), the close routine creates data set trailer labels. . 


Writing Data Set Trailer Labels 


The close routine writes the data set trailer labels with the identifiers EOF1 and 
EOF2. Except for the label identifiers and the block count, these labels are 
created in the same manner and with the same content as the data set header 
labels. 


The close routine writes two tapemarks following the trailer labels. If user 
labels are to be written, the tapemarks follow the user trailer labels. If another 
data set is added to the tape (multiple data set organization), its HDR1 label 
overlays the second tapemark. 


Writing User Trailer Labels 


When AUL is coded on the DD statement and the address of an output user 
trailer label routine is specified in the DCB exit list, the close routine can write 
as many user trailer labels (UTL) as desired. 


The contents of user trailer labels are not checked during close processing, but, 
if they contain any invalid ISO/ANSI/FIPS characters, the condition will be 
detected during a subsequent open for RDBACK. 


IBM 3480 Tape Processing 


To improve performance when processing labels of ISO/ANSI/FIPS labeled 
volumes on an IBM 3480 Tape Subsystem (with or without Improved Data 
Recording Capability) the open and EOV routines attempt to avoid changing the 
direction of tape movement. 


Checkpoint/Restart Not Allowed 


Any ISCII/ASCII tape that is open during a CHKPT macro service will prevent a 
checkpoint from being taken. 


Format of the Version 3 Volume Label (VOL1) 


Figure 14 on page 8/7 shows the format of the Version 3 volume label. The 
Shaded areas represent fields that are recorded in the label, but are not used 
or verified during processing. The contents and processing of each field of the 
label are described, as are differences between the Version 3 volume label and 
the IBM volume label. 
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Figure 14. Format of the Version 3 Volume Label 


1—Label Identifier (3 bytes) 
¢ Contents: The characters VOL identify this label as a volume label. 


e Processing: This field is read to verify that a standard labeled tape is 
mounted, and that this label is a volume label. 
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The labels are created by the IEHINITT utility program or a user’s program. 


In the following situations, the open or EOV routines create a Version 3 
volume label based on specifications in your DD statement: 


— If you request a Version 3 output volume (AL, AUL), and an NL, NSL, or 
SL labeled volume is mounted to satisfy your request 


— If you request a Version 3 output volume (AL, AUL), and a volume that 
can be overwritten and that is recorded in the wrong density is mounted 
to satisfy your request (only if output is for the first data set on the 
volume) 


2—Label Number (1 byte) 


e Contents: The relative position of this label within a set of labels of the 


same type; it is always a 1 for the Version 3 volume label. 


e Processing: Verified in conjunction with Field 1 to identify this label as 


VOL1. 


3—Volume Identifier (6 bytes) 


e Contents: A unique identification code, Known in the system as the volume 


serial number, that is assigned through JCL or IEHINITT to the volume when 
it enters the system, or that is assigned by the operator when open or EOV 
routines label the volume. This code may also appear on the external 
surface of the volume for visual identification. The code is normally 
numeric (000001 to 999999), but can be from 1 to 6 characters long. If the 
code is less than 6 characters long, it must be left-justified, and will be 
padded with blanks. 


All national characters and some special characters in this field will be 
rejected during open as invalid ISO/ANSI/FIPS characters. For a list of the 
valid ISO/ANSI/FIPS characters, see “Label Definition and Organization” on 
page 59. 


Processing: The user-specified volume serial number is obtained from the 
JFCB and recorded in the UCB. Then the number in the UCB is compared 
to the number in this field of the label to ensure that the correct volume is 
mounted. | 


For scratch output tapes, the volume serial number is obtained from this 
field of the label and recorded in both the JFCB and the UCB. 


Difference from IBM Field: The corresponding field in an IBM standard label 
is called "Volume Serial Number.” 


4—Accessibility (1 byte) 


e Contents: An uppercase letter from A through Z indicates that the 


RACHECK installation exits will be entered and will receive accessibility 
parameters, or the volume access exit will be entered in order to accept or 
reject the volume. A space indicates that the volume is authorized for 
access, unless RACE rejects the volume. All other characters will cause 
the volume to be rejected if the volume is not defined to RACF. 


Processing: \f this field contains any character other than a space or an 
uppercase letter from A through Z, the volume is rejected by the system, 
unless the volume has been defined to RACF. 
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¢ Difference from IBM Field: The corresponding field in an IBM standard label 
is reserved and currently unused. 





5—Reserved for Future Standardization (26 bytes) 
e Contents: Reserved for possible future use; should be recorded as blanks. 


e Processing: Not used or verified, except to check for all blanks. The 
IEHINITT utility program writes blanks in this field. (Blanks are translated to 
ISCII/ASCII space characters on output.) 


6—Owner Identifier (14 bytes) 


« Contents: Indicates a specific customer, person, installation, department, 
and so forth, to which the volume belongs. Any code or name is accept- 
able. 


e Processing: Not used or verified, except to check for valid ISO/ANSI/FIPS 
7 characters. The IEHINITT utility program writes the text specified by the 
{ user, and the open and EOV routines write the text specified by the oper- 
ator. If the code is less than 14 bytes long, it is left-justified and the 
remainder of the field is padded with blanks. (Blanks are translated to 
ISCII/ASCII space characters on output.) 


¢« Difference from IBM Field: The corresponding field on an IBM standard 
label is 10 bytes long. 
7—Reserved for Future Standardization (28 bytes) 
¢ Contents: Reserved for possible future use; should be recorded as blanks. 


( : ¢ Processing. Not used or verified, except to check for all blanks. The 
IEHINITT utility program writes bianks in this field. (Blanks are translated to 
ISCII/ASCII space characters on output.) 
8—Label Standard Level (1 byte) 


¢ Contents: A 3 signifies that the tape is formatted according to Version 3 
interchange standards. 


¢ Processing: The operating system will always place a 3 in this field on 


( ‘ output. Version 1 tapes contain a1 in this field and are accepted for input 
| processing. Any character other than a1 ora 3 inthis field is rejected by 
the system. 


e Difference from IBM Field: This field is blank in IBM standard labels. 


Format of the Version 3 Data Set Label 1 (HDR1/EOV1/EOF1) 


Figure 15 on page 90 shows the format of HDR1, EOV1, and EOF1. The shaded 
areas represent fields that the operating system writes in the label, but that are 
not used or verified during processing. The contents and processing of each 
field of the label are described, as are differences between the Version 3 labels 
and the IBM labels. 
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Figure 15. Format of Version 3 Header 1 and Trailer 1 Labels 
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1—Label Identifier (3 bytes) 
e Contents: Three characters that identify the label are as follows: 
— HDR Header label (at the beginning of a data set) 


— EOV Trailer label (at the end of a tape volume, 
when the data set continues on another volume) 


— EOF Trailer label (at the end of a data set) 


e Processing: Data management checks this field to verify that the record is 
an ISO/ANSI/FIPS data set label. 


For input data sets, data management checks the label identifier to deter- 
mine whether data set processing is to be continued. When data manage- 
ment finds an EOV label, it performs volume switching. When data 
management finds an EOF label, it passes control to the user’s end-of-data 
routine. 


If the DD statement specifies OPTCD=B for an input data set, the trailer 
label identifier (EOV or EOF) is not used to determine whether a volume 
switch is necessary. If more volumes are available, data management per- 
forms the switching. If no volumes are available, data management passes 
control to the user’s end-of-data routine. 


When creating trailer labels, the EOV routine writes EOV in this field, and 
the close routine writes EOF. 


2—Label Number (1 byte) 


e Contents: The relative position of this label within a set of labels of the 
same type; it is always a 1 for data set label 1. 


e Processing: Verified and written in conjunction with Field 1 to identify this 
label as HDR1, EOV1, or EOF1. 


3—File Identifier (17 bytes) 


« Contents: The rightmost 17 bytes of the data set name, not including the 
suffix .GxxxxVyy for generation data sets (Version 1 tapes will continue to 
be accepted for input with the suffix included as part of the file identifier). If 
the data set name is fewer than 17 bytes, it is left-justified and the 
remainder of this field is padded with ISCII/ASCII space characters. 


If the name contains embedded spaces or other special characters, you 
must enclose the name in apostrophes on the DD statement that requests 
this data set. JCL User’s Guide lists the restrictions that apply to enclosing 
a data set name in apostrophes. The apostrophes do not appear in the 
data set identifier field. | 


« Processing: For input, this name is compared to the user-specified data set 
name found in the JFCB. This ensures that the correct data set is being 
processed. It is also compared to the names of other data sets on the 
volume during open positioning to ensure against duplicate names (see 
“Processing the HDR1 Label” on page 72 for more information). 


For output, the data set name in the existing label is verified in conjunction 
with password protection to determine whether the existing data set can be 
overwritten. If password protection is not specified, the data set name is 
not checked, except for valid ISO/ANSI/FIPS characters. — 


Chapter 3. ISO/ANSI/FIPS Labels 91 


When creating labels for a new data set, the user-specified data set name is 
obtained from the JFCB and recorded in this field. 


¢ Difference from IBM Field: The corresponding field in an IBM standard label 
is called “Data Set Identifier.” 





- 4—File Set Identifier (6 bytes) 


¢ Contents: The volume serial number of the tape volume containing the data 
set. For multivolume data sets, this field contains the serial number of the 
first volume of the aggregate created at the same time. 


If the volume serial number is assigned in the JCL statements, all national 
characters and some special characters will be rejected during open as 
invalid ISO/ANSI/FIPS characters. See “Label Definition and Organization” 
on page 59 for a list of the valid ISO/ANSI/FIPS characters. If the code is 
fewer than 6 characters long, it must be left-justified. 


e Processing: Not used or verified, except to check for valid ISO/ANSI/FIPS 
characters. When creating labels, the serial number is obtained from the ye 
UCB and recorded in this field. : 


e Difference from IBM field: The corresponding field on an IBM standard label 
is called “Data Set Serial Number.” 


5—File Section Number (4 bytes) 


e Contents: A number (0001 to 9999) that indicates the order of the volume 
within the multivolume group created at the same time. This number is 
always 0001 for a single volume data set. 


e Processing: Not used or verified, except to check for valid ISO/ANSI/FIPS 
characters. When creating labels, the open routine writes 0001 in this field; 
the EOV and close routines obtain the current volume sequence number 
from the DEB. 


¢ Difference from IBM Field: The corresponding field on an IBM standard 
label is called “Volume Sequence Number.” 


6—File Sequence Number (4 bytes) 


¢ Contents: A number (0001 to 9999) that indicates the relative position of the 
data set within a multiple data set group. This number is always 0001 for a 
single data set organization. 


e Processing: This number in the first HDR1 label on the tape is referred to 
when the open routine positions the tape. If this number in the first HDR1 
label and the requested data set sequence number in the JFCB are both 
greater than 1, the logical data set sequence number in the UCB is set to 
the number in the label. Otherwise, the logical data set sequence number 
in the UCB is set to 1. 


When creating labels, the open and close routines obtain the user-specified 
_ data set sequence number from the JFCB (a 0 is changed to 1). The EOV 
routine obtains this number from the logical data set sequence number in 


the UCB. 
7—Generation Number (4 bytes) cy 
° Contents: If the data set is part of a generation data group, this field con- e 


~ tains a number from 0001 to 9999 indicating the absolute generation number 
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(the first generation is recorded as 0001). If the data set is not part of a 
generation data group, this field contains 0001. 


( « Processing: A nonnumeric or all zero value is invalid, and will cause the 
label validation exit to be entered unless validation has been suppressed. 


When creating labels, data management checks the JFCB to determine 
whether the data set is part of a generation data group. If so, the gener- 
ation number is obtained from the last part of the data set name in the 
JFCB. Otherwise, this field is recorded as 0001. 


8—Version Number (2 bytes) 


¢ Contents: If the data set is part of a generation data group, this field con- 
tains a number from 00 to 99 indicating the version number of the gener- 
ation (the first version is recorded as OO). If the data set is not part of a 
generation data group, this field contains ISCII/ASCII zeros. 


ae ¢ Processing: Data management always records this field as zeros. Fora 
( : version level other than zero, you must specify the absolute generation and 
version numbers as part of the data set name when creating or retrieving a 
data set. 


9—Creation Date (6 bytes) 


¢ Contents: Year and day of the year when the data set was created. The 
date is shown in the format cyyddd, where: 


c = century (blank=19; 0=20; 1=21) 
Poe yy = year (00-99) 
( ddd = day (001-366) 


¢ Processing: Not used or verified, except to check for proper format. When 
data management creates labels, the date is obtained from the JFCB. This 
is the date the job was initiated for execution, and not necessarily the date 
the label was created. | 


10—Expiration Date (6 bytes) 


¢ Contents: Year and day of the year when the data set may be scratched or 
overwritten. The data is shown in the format cyyddd, where: 


( c = century (blank=19; Q=20; 1=21) 
yy = year (00-99) 
ddd = day (001-366) 


HT 


¢ Processing: For input, not used or verified, except to check for proper 
format. For output, the expiration date in the existing label is compared to 
the current date shown in the communications vector table (CVT). If the 
date in the label is later than the current date, the operator receives a 
message and is given the option of using the tape or mounting another. If 
other data sets are on the same volume, data management checks the 
expiration date of the immediately preceding data set. If the previous data 
set’s expiration date is earlier than that of the output data set, the label val- 
idation exit is entered (unless label validation has been suppressed). Any 
data sets following on the volume are treated as if they had expired on the 
same day as the output data set. 





When creating labels, data management obtains the expiration date from 
the JFCB. If you did not specify a retention period or expiration date, the 
expiration date is recorded as zeros and the data set is considered expired. 
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11—Accessibility (1 byte) 


¢ Contents: A code indicating the security status of the data set, as follows: 





Uppercase A-Z If the volume is not RACF protected, the file access exit 
will be entered. 


Space No data set access protection. 


1 Password protection. Additional identification of the data 
set is required before it can be read, written, or deleted. 
(Ignored if volume is RACF defined.) This can be speci- 
fied in the PASSWORD subparameter of the LABEL 
keyword of JCL. 


3 Password protection. Additional identification of the data 
set is required before it can be written or deleted. 
(Ignored if volume is RACF defined.) This can be speci- 
fied in the NOPWREAD subparameter of the LABEL 
keyword of JCL. a 


Other character Protected volume. No access is possible under the oper- Se 
ating system, unless the volume has been defined to 
RACF and is authorized for use by RACF. 


e Processing: For input, data management inspects this field on a single 
volume data set, on each concatenated data set, and on each volume of a 
multivolume data set. If password protection is specified in this field, data 
management verifies the password furnished by the operator or TSO ter- 
minal user and sets a security indicator in the JFCB. If an uppercase letter 
from A through Z is specified and the volume is not defined to RACF, the a 
file access exit will be entered (the IBM-supplied exit will reject the 7 
volume). If a character other than an ISCII/ASCII space, an uppercase letter 
from A through Z, a 1, or a 3 is encountered, the DCB will not be opened 
and no further processing will take place. 


For output, data management inspects this field in the existing HDR1 label. 
Ifa 1ora3 is specified, with the system code “IBMZLA”, the existing data 
set cannot be overwritten until data management verifies the password and 
the data set name in Field 3 of this label (password checking is bypassed if 
the volume is defined to RACF). If you specify a data set name different 
from the one in Field 3, and the data set is the first one on the first or only 
volume, the operator is requested to demount the tape and mount a scratch 
tape, even though you requested a specific volume. If the data set is not 
the first one on the volume or this is not the first volume of a multivolume 
data set, the job is abnormally terminated. If an uppercase letter from A 
through Z is specified and the volume is not defined to RACF, the file 
access exit will be entered (the IBM-supplied exit will reject the volume). 


When data management creates labels, the user’s request for security ts 

determined from the indicator in the JFCB for password processing, or from 
a JCL ACCODE value, which will be maintained internally in an SWB control 
block. Password codes override ACCODE values if they are both specified. 


12—Block Count (6 bytes) 


¢« Contents: This field in the trailer label shows the number of data blocks in 
the data set on the current volume. This field in the header label is always 
zero (000000). 
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« Processing: The DCB block count (in the device-dependent area of the 
DCB) is increased as the data set is read. The final DCB count ts compared 
with the count in the trailer label at end of data or end of volume. If the 
counts do not agree, a user exit entry in the DCB exit list determines 
whether processing will continue or abnormally terminate. If the appro- 
priate user exit entry is not provided, a block count discrepancy causes 
processing to abnormally terminate. 


For read backward, the verification process is reversed. The trailer label 
count is recorded in the DCB and decreased as the data set is read. The 
final DCB count should be 0, which is equal to the count in the header label. 


When data management creates labels, the block count in the header label 
is set to zeros. The biock count in the trailer label is obtained from the 
DCB during close and EOV label creation. 


lf the data set was created with a DCB that had no device-dependent area, 
and the volume was not rejected, the block count is written as zero and is 
not verified. For tapes with Version 3 labels, a data set opened without at 
least a 4-word device-dependent area in the DCB will cause the label vali- 
dation exit to be entered with a symmetry error, unless validation has been 
suppressed. The default of the exit is to reject the volume. 


13—System Code (13 bytes) 
e Contents: A unique code, IBMZLA, that identifies the system. 


Note: Version 1 tapes produced by MVS contain OS360 or OS370 as a 
system code. 


e Processing: On input, the field is checked to determine how succeeding 
labels are to be processed (the field determines whether Field 3, “Record 
Format,” and Field 6, “Reserved for Operating System,” in the second 
header label will be processed). On output, the operating system supplies 
the “IBMZLA” code. 


14—Reserved for Future Standardization (7 bytes) 
« Contents: Reserved for possible future use; contains blanks. 


¢ Processing: Not used or verified, except to check for blanks. When creating 
labels, data management writes blanks in this field. (Blanks are translated 
to ISCII/ASCII space characters on output.) 


Format of the Version 3 Data Set Label 2 (HDR2/EOV2/EOF2) 


Figure 16 on page 96 shows the format of HOR2, EOV2, and EOF2. The shaded 
areas represent fields that the operating system writes in the label, but that are 
not used or verified during processing. The contents and processing of each 
field of the label are described, as are differences between Version 3 labels and 
IBM labels. 


If the labels are produced by the operating system, they are treated like IBM 


header 2 and trailer 2 labels. If the labels are produced by another system, the 
“Reserved for Operating System” and “Record Format” fields will not be used. 
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Figure 16. Format of Version 3 Header 2 and Trailer 2 Labels 
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1—Label Identifier (3 bytes) 
Be. * Contents: Three characters that identify the label are as follows: 
( — HDR Header label (at the beginning of a data set) 


— EOV Trailer label (at the end of a tape volume, 
when the data set continues on another volume) 


— EOF Trailer label (at the end of a data set) 


¢ Processing: Data management checks this field to verify that the record is 
an ISO/ANSI/FIPS data set label. 


For input data sets, data management checks the label identifier to deter- 
mine whether data set processing is to be continued. When data manage- 
ment finds an EOV label, it performs volume switching. When data 
management finds an EOF label, it passes control to the user’s end-of-data 
routine. 


: lf the DD statement specifies OPTCD=B for an input data set, data manage- 
( | ment accepts either EOV or EOF as the trailer label identifier, and the iden- 
: tifier is not used to determine whether a volume switch is necessary. If 
more volumes are available, data management performs the switching. If 
no volumes are available, data management passes control to the user’s 
end-of-data routine. 


When creating trailer labels, the EOV routine writes EOV in this field, and 
the close routine writes EOF. 


2—Label Number (1 byte) 


( ; | ¢ Contents: The relative position of this label within a set of labels of the 
. same type; it is always 2 for data set label 2. 


e Processing: Verified and written in conjunction with Field 1 to identify this 
label as HDR2, EOV2, or EOF2. 


3—Record Format (1 byte) 


¢ Contents: An alphabetic character that indicates the format of the records 
in the associated data set: 


( — F Fixed length 
— D Variable length 
—- S$ Spanned 


Note: RECFM=U (undefined length) is accepted for input from a 
Version 1 tape. If specified for input or output for Version 3 tapes, the 
label validation exit is entered. 


For detailed information about record formats, see Data Administration 
Guide. 


¢ Processing: For input, the record format is obtained from this label and 
recorded in the JFCB (if the JFCB field is 0). Then the record format in the 
JFCB is recorded in the DCB (if the DCB field is 0). Note that this is a 
merging process in which existing specifications in the JFCB and DCB 
cannot be overridden. 
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Record format will not be accepted from the label if the block attribute (in. 
Field 6) is not applicable to MVS; in this case, record format must be speci- 
fied in JCL or in the DCB. 7 


When creating labels, a reverse merge follows the forward merge described 
above. The record format in the DCB overrides the record format in the 
JFCB, and the updated JFCB provides the information for the label. 


This merging process is explained and illustrated in the introduction. 


4—Block Length (5 bytes) 


e Contents: A number from 18 to 2048 that indicates the block eng 
(including buffer offset and padding) in bytes. 


Note: The 18-byte to 2048-byte limit on block length is an ISCII/ASCII 
standard. Larger blocks (up to 9999 bytes) may be specified with the agree- 
ment of the interchange parties. However, for tapes with Version 3 labels, 
exceeding the 2048-byte limit causes the label validation exit to be entered. 


Interpretation of the number depends on the associated record format in 
Field 3, as follows: 


— Format F Block length. 


— Format D Maximum block length (including the 4-byte 
length indicator in the records and 
the optional block prefix). 


— Format S Maximum block length (including the optional 
block prefix, plus one or more pairs of 5-byte 
segment control words and segments). 


¢ Processing: The number in the label is converted to binary and merged 
with appropriate fields in the JFCB and DCB. The merging process is the 
same as that for the record format code in Field 3 of this label. 


5—Record Length (5 bytes) 


° Contents: A number that indicates the record length in bytes. Interpreta- 
tion of the number depends on the associated record format in Field 3, as 
follows: 


— Format F Actual record length. 


— Format D Maximum record length (including the 4-byte 
length indicator in the records and the optional 
block prefix). 


— Format S Maximum record length (excluding all the 
5-byte segment control words that describe 
the record). If the record is larger than 
99999, this field is zero. 


e Processing: The number in the label is converted to binary and merged 
with the appropriate fields in the JFCB and DCB. The merging process Is 
the same as for the record format code in Field 3 of this label. 
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6—Reserved for Operating System (35 bytes) | 


" ¢ Contents: If the label is produced by this operating system (the system 
( : code in the first header label is “IBMZLA”), the content and format of this 
field are similar to the content and format of the seven fields following the 
record length field in an IBM standard label. If the label is produced by 
another system, the content and format of this field are optional, and the 
field is not processed by the operating system. The fields produced by the 
operating system are: | 


— Tape Density (1 byte) 


— Contents: A code indicating the recording density of the tape; the 
code is equivalent to the DEN parameter value on the DD statement 
(for the DEN parameter values, refer to “Tape Characteristics” on 


page 9). 
— Processing: lf DCB =DEN was not specified in JCL, this data is | 


merged in the JFCB for input. When data management creates 
labels, the information for this field is obtained from the JFCB. 





( — Data Set Position (1 byte) 
— Contents: A code indicating a volume switch is as follows: 
O No volume switch has occurred. 
4 A volume switch previously occurred. 


— Processing: Not used or verified. When creating labels, the open 
routine. writes 0 in this field, and the EOV routine writes a1. The 
= — close routine determines which code to write by comparing the 
( volume serial number in the JFCB to the number in the UCB. It 
| writes O if the numbers are equal, and 1 if they are not equal. 


— Job/Job Step Identification (17 bytes) 


~— Contents: Identification of the job and job step that created the data 
set. The first 8 bytes contain the name of the job; the 9th byte is a 
slash (/), and the last 8 bytes contain the name of the job step. 


— Processing: Not used or verified. When data management creates 
labels, the names of the job and job step are obtained from the 


( TIOT. 
' — Tape Recording Technique (2 bytes) 


— Contents: Recorded as blanks for 9-track tape; 9-track tape can 
only be recorded in odd parity with no translation. 


— Processing: Not used or verified. 
— Control Characters (1 byte) 


— Contents: A code indicating whether a control character set was 
used to create the data set, and the type of control characters used: 


A Contains ISO/ANSI/FIPS contro! characters. 
b Contains no control characters. 


—_ Processing: The specification in the label is converted to a bit code 
and merged with the Record Format field in the JFCB if ASCII car- 
riage control was not specified as part of DCB =RECFM in JCL. 
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— Buffer Alignment Block (1 byte) © 
| — Contents: Reserved for future use; recorded as blanks. 


— Processing: Not used or verified. When creating labels, data man- 
agement writes blanks in this field. 


— Block Attribute (1 byte) 


— Contents: A code indicating the block attribute used to create the 
data set: 


B Blocked records 
b Records not blocked 


— Processing: The specification in the label is converted to a bit code 
and merged with the record format field in the JFCB. The merging 
process is the same as for the record format code in Field 3 of this 
label. 


7—Buffer Offset (2 bytes) 


e Contents: The length of the block prefix (from O to 99). 


e Processing: Used to determine the length of an optional prefix that may be 
a part of a physical block on tape. The version of the prefix for variable and 
Spanned record formats is known as a block descriptor word (BDW). A 
BDW is always four bytes long and contains the block length (of the phys- 
ical record it describes, including the BDW). The BUFOFF=L operand 
informs the system that the prefix is an MVS BDW. The prefix is not made 
available as part of the data read into storage by the queued access 
method. (For more information about block descriptor words, see Data 
Administration Guide.) 


* Difference from IBM Field: This field is not present in IBM standard labels. 


8—Reserved for Future Standardization (28 bytes) 


¢ Contents: Reserved for possible future use; recorded as blanks. (Blanks 
are translated to ISCII/ASCII space characters on output.) 


e Processing: Not used or verified. When creating labels, data management 
writes blanks in this field. 


Format of Version 3 User Header and Trailer Labels (UHL/UTL) 


Figure 17 on page 101 shows the format of UHL and UTL labels. 
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Figure 17. Format of Version 3 User Labels 


1—Label Identifier (3 bytes) 
¢ Contents: Three characters that identify the label are as follows: 
— UHL User header label (at the beginning of a data set) 


— UTL User trailer label (at the end-of-volume or end- 
of-data-set) 


e Processing: This field ts read to verify that the record is a user label. Data 
management accepts either UHL or UTL. 


2—Label Number (1 byte) 
* Contents: Any valid ISO/ANSI/FIPS character. 


e Processing. This field is checked by the operating system for a valid 
ISO/ANSI/FIPS character during creation of a user header label (UHL) 
during open/EOV if validation has not been suppressed. If an invalid char- 
acter is detected, the label validation exit is entered. 


e Difference from IBM Field: This field can contain only numeric 1 to 8 for 
IBM standard user labels. A maximum of 8 user header or trailer labels is 
supported for conventional IBM standard user labels, but any number of 
user labels can be written for ISO/ANSI/FIPS tapes, and they may be let- 
tered or numbered in any order. 


3—User Specified (76 bytes) 


« Contents: Specified by the user, but must be valid ISO/ANSI/FIPS charac- 
ters. | 


e Processing: Specified in the DCB exit list. This field is checked as 
explained for Field 2. 
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Other File Header Labels 


Other file header labels (HDR3-HDR9, EOF3-EOF9, EOV3-EOV9) and user volume 
labels (UVL1-UVL9) will not be created by the operating system. Because these 
labels may appear on magnetic tapes created by other systems, the operating 
system will accept them as input. Those labels are ignored during label proc- 
essing and are not placed on output tapes. Ignored labels are checked only for 
a valid label identifier and proper label sequence; no checks are made for 
ignored labels encountered during positioning to the requested data set. 


Figure 18 shows a hypothetical input tape from a non-IBM system and a corre- 
sponding output tape produced by the operating system. The user volume 
label, the additional header label, and the additional trailer label are not placed 
on the output tape. 


INPUT (Non-IBM) a OUTPUT (IBM) 
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Figure. 18. Example of an ISO/ANSI/FIPS Tape from a Non-IBM System and a Corresponding Output Tape 
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[_ Product-Sensitive Programming Interface ~ 7 


This chapter contains product-sensitive programming interfaces provided by 
DFP. Installation exits and other product-sensitive interfaces are provided to 
allow the customer installation to perform tasks such as product tailoring, moni- 
toring, modification, or diagnosis. They are dependent on the detailed design | 
or implementation of the product. Such interfaces should be used only for | 
these specialized purposes. Because of their dependencies on detailed design : 
and implementation, it is to be expected that programs written to such inter- 

faces may need to be changed in order to run with new product releases or 

versions, or as a result of service. 





aes Nonstandard labels do not conform to the IBM or ISO/ANSI/FIPS standard label 
( formats. They are labels which you design, and you provide routines to write 
and process them. There are no requirements as to the length, format, con- 
tents, and number of nonstandard labels, except that the first record on a BCD, 
EBCDIC, or ISCII/ASCII tape cannot be a standard volume label. 


Nonstandard label routines may be inserted into the control program after 
system generation by link-editing them into LPALIB. 


To insert your load modules into the SVC library during system generation, you 
pe, use the SVCLIB macro instruction. With this macro instruction, you must 
( specify the name of the partitioned data set and the names of members to be 
included in the SVC library. Member names for the first load module of each 
type of label processing routine are listed below. Member names for additional 
load modules must begin with the letters NSL or IGC. The format and specifica- 
tions of the SVCLIB macro instruction are in System Generation Reference. 


Nonstandard Label Control Program | 
Processing Routine Routine Member Name 
a Input Header Open NSLOHDRI 
( EOV NSLEHDRI 
Output Header Open NSLOHDRO 
EOV NSLEHDRO 
Input Trailer EOV NSLETRLI 
Output Trailer EOV NSLETRLO 
Close NSLCTRLO 
Restart Reader Restart NSLRHDRI 


If you use nonstandard tape labels and you want to use the dynamic device 
reconfiguration (DDR) option, you must perform your own volume verification. 
a Note that you must be able to perform your verification within the first 48 bytes 
¢ | of any record in your nonstandard label. 
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Before system generation time, code a routine named NSLREPOS and link-edit 


it into a cataloged partitioned data set. Then, identify the member of the parti- , 
tioned data set that contains NSLREPOS in the LPALIB system generation y i 
macro instruction. Link-edit NSLREPOS into the LPALIB after system gener- = 
ation. 


For detailed information about these and other available exit routines, see Data 
Facility Product: Customization. 


ee End of Product-Sensitive Programming Interface ee 
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Chapter 5. Unlabeled Tapes 


To process or create a tape with no labels, specify NL in the LABEL parameter 
of the DD statement. An unlabeled tape contains only data records and 
tapemarks. The organization of data sets on one or more volumes is shown in 
Figure 19 on page 107. The data management routines of the operating 
system automatically write the tapemarks on output and expect to find a similar 
placement of tapemarks on input. 





e A tapemark does not precede the first data set on any volume. 
e A tapemark follows every data set. 


e Two tapemarks follow a data set if it is the last or only data set on the 
volume. | 


; An unlabeled tape can be read backward even though there is no tapemark 
( * preceding the first data set. In this case, the end-of-data-set condition is sig- 
, naled by the reflective strip at the beginning of the tape. 


Open/Close/EOV look ahead mounting does not accept any volume that is pre- 
mounted and not verified on the next available unit (UCBNRY =O and 
UCBYOLI= ZEROS). A demount message with a blank vol ser is issued. 


Note: Automatic volume recognition (AVR) automatically recognizes mounts of 
labeled volumes. If JCL-specific requests are used and a volume that is not 
specified is mounted at allocation time, data management requests a demount 
< of the incorrect volume and a mount of the specified volume. Eliminate specific 
( requests in the JCL to avoid this problem. 


Bypass Label Processing (BLP) Option 


To use the BLP option, the user is responsible for proper tape positioning 
because Open/Close/EOV cannot determine if the tapes are labeled or unla- 
beled. BLP processing is identical to NL processing, except that the check for 
an existing label is bypassed. BLP processing positions second and subse- 
quent volumes of a multivolume data set as if it were unlabeled. This posi- 
tioning is incorrect if the data set has labels. 





Opening an Input Data Set 


When you specify no labels, data management checks the input tape to ensure 
that the first record is not a standard volume label (that is, the first 4 characters 
are not VOL1 in EBCDIC or ASCII). If the first record is a standard volume 
label, the tape is rejected, with a message from data management directing the 
operator to mount the correct tape. The various error conditions that can occur 
during label verification are explained under Chapter 6, “Volume Label Verifica- 
tion and Volume Label Editor Routines” on page 113. 


The search for a standard label is the only mount verification performed by data 
management. Without labels, neither the volume nor the data set can be posi- 
tively identified and data management assumes that they are correct. The 
operator is responsible for checking the reel’s external identification to ensure 
compliance with the mount message. 
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Positioning the Volume to the Data Set 
When the tape is accepted for input, data management positions the pe at the 
first record of the data set to be processed. Usually there is only one data set 
on the volume and positioning is set to the first record on the tape. 





To retrieve a data set when there are more than one on a single reel of tape, 
you specify a data set sequence number in the LABEL parameter of the DD 
statement, unless the data set is cataloged. You need not specify a data set 
sequence number for a cataloged data set, because the number can be 
obtained from the catalog along with the volume serial number. 


¢ The sequence number can be from 1 to 9999, with 1 representing the first 
data set on the volume. If you specify a sequence number higher than the 
number of data sets on the volume, the tape will be spaced through and 
removed from its reel. | 


* If you do not specify a sequence number, or specify zero, and the data set 
is not cataloged, data management assumes that the data set is first in 
sequence on the volume. —_ 


¢ The first data set on an unlabeled tape is not preceded by a tapemark. Ifa Fie 
tapemark precedes the first data set, the sequence number of that data set 
is two (the effect is as if a data set containing no data preceded the 
tapemark). 





106 MVS/XA Magnetic Tape Labels and File Structure Administration 

















ce Single Data Set 
! Single Volume 





Data oa 
Set 


tb 











Multiple Data Sets 
Single Volume 




















Single Data Set 
Multiple Volumes 

















a | 
First Last 
| Part Part 
ee of ~~ px of a 
ae Data Data 
Set | Set 
TM 
i 
Multiple Data Sets 
Multiple Volumes 
Vol 1o0f3 Vol 2 of 3 Vol 3 of 3 
Last | 
Part 
re of = 
cas Data ' 
Set B 
enter tnnnsnennnrmnnmen 
| TM 
cami ee 
Data Set B 
Continued 














Figure 19. Organizations for Unlabeled Tapes 





To position the tape, data management uses the requested data set sequence 
number shown in the JFCB and maintains a logical data set sequence number 
in the unit control block (UCB). The number in the UCB represents the current 
position of the tape and is maintained as follows: 


1. When a tape is first mounted, the data set sequence number in the UCB is 
0. 


2. When a data set is opened, the open routine sets the data set sequence 
number in the UCB to 1. If the tape is still positioned from previous proc- 
essing, such as for a LEAVE request, the open routine does not reset the 
number in the UCB. This means that multiple volume, multiple data set NL 
tape, unlike SL tape, requires a different JCL data set sequence number, 
unless the tape stays mounted. 
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Read Backward 


3. The data set sequence number in the UCB is compared to the requested 
data set sequence number in the JFCB. If they are equal, the tape is 
already positioned at the requested data set. If they are not equal, the 
Open routine adjusts the data set sequence number in the UCB as the tape 
is positioned past each data set until the number in the UCB equals the 
number in the JFCB. 


4. To position to a data set when there are multiple data sets on multiple 
volumes, specify the volume serial numbers of the volumes on which the 
data set resides in the VOLUME parameter of the DD statement and the 
data set sequence number in the LABEL parameter. You need not specify 
the volume serial number or the data set sequence number for a cataloged 
data set. 


5. When multiple tape units are used and a volume switch causes processing 
to be continued on a volume on a different unit, the EOV routine copies the 
data set sequence number from the previous UCB to the current UCB. 


No more than one data set on a tape volume may be open at any given time. If 


you attempt to begin processing a second data set on the same volume, proc- 
essing is abnormally terminated. 


For the read backward (RDBACK) operation, the data records are retrieved in 


“reverse sequence. Multivolume data sets can be read backward. Concat- 


enated data sets cannot be read backward. Format-V (variable-length) records 
cannot be read backward. Seven-track tape with data conversion cannot be 
read backward. 


End-of-Data or End-of-Volume on Input 


Determining Volu 


For input, data management’s EOV routine handles both end-of-data-set and 
end-of-volume conditions. These conditions occur when: 


e A tapemark is read, or 


° A force-end-of-volume (FEOV) macro instruction is executed by the proc- 
essing program. 


me Switch 

The serial numbers of all volumes of the data set to be processed must be 
specified by the user at execution time. The serial numbers are specified either 
directly in the DD statement or indirectly through the catalog procedure. You 
specify the serial numbers in forward sequence, regardless of whether the 
tapes are to be read forward or backward. 


e For noncataloged data sets, you specify the volume serial numbers in the 
VOLUME parameter of the DD statement. Data management processes the 
group of volumes in whatever order you specify and processes only the 
volumes you specify. 


e For cataloged data sets, the group of volumes must be processed in 
sequential order. However, you can begin processing at any volume of the 
group by specifying a sequence number in the VOLUME parameter of the 
DD statement. 
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For input, the volume serial numbers specified by the user are the basis for 
determining whether a volume switch is required. Data management does not 
consider whether the data set on the current volume is followed by one or two 
tapemarks. To determine whether additional volumes are required, data man- 
agement maintains a volume sequence number in the data extent block (DEB) 
in storage. 


¢ For read forward operations, the volume sequence number in the DEB is 
increased as each volume is processed. This count is compared to the 
total number of volumes requested, as shown in the JFCB. 


e For read backward operations, the volume sequence number in the DEB is 
set to the number of volumes requested, as shown in the JFCB. This count 
in the DEB is decreased as each volume is processed until the count equals 
0. 


If another volume is required, data management obtains the next volume Serial 
number from the JFCB and switches volumes. Data management checks the 
initial record of the new volume to ensure that it is not a standard volume label 
and positions the tape to the data set. For a multivolume data set, the tape is 
positioned to the first record on the new volume. For a concatenated data set, 
the tape is positioned according to the specified data set sequence number. 


lf another volume is not required, control is given to the user’s end-of-data-set 
routine that is specified in the data control block. Subsequently, the processing 
program or the operating system closes the data set. 


« The user’s end-of-data-set routine is not entered until the last specified 
volume or the last concatenated data set is processed. 


¢ If an input data set is closed before it reaches the end of the data set, the 
user’s end-of-data-set routine is not entered. 


Opening an Output Data Set 


When you specify unlabeled tape, data management checks the output tape to 
ensure that the existing first record is not a standard volume label. If the first 
record is 80 bytes in length and contains the identifier VOL1 in the first 4 bytes, 
data management checks for the following conditions, in the order presented: 
(1) RACF authorization, (2) password protection, and (3) expiration date. 


If the system-wide RACF tape protection option has been selected, data man- 
agement checks the alter level authorization to the tape volume. If the tape 
volume is not defined to RACF, password protection is checked. If the tape 
volume is defined and the user is not authorized for ALTER, the tape is 
demounted; if the user is authorized for ALTER, password protection is 
bypassed. 


If data management determines that the volume is password protected, a 
message to demount the tape is issued to the operator. Otherwise, data man- 
agement continues processing by checking the expiration date. If the expiration 
date is earlier than the current date, a message is issued, and the operator can 
either refuse or allow the use of the tape. If the expiration date is later than the 
current date, another message is issued, and again the operator can refuse or 
allow the use of the tape. If in either situation the operator refuses the use of 
the tape, data management requests that another volume be mounted. Ifthe 
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operator accepts the tape, data management then destroys the standard label 
by writing a tapemark over it, thus providing you with the unlabeled tape you 
requested. 





If the tape volume has been found to be RACF defined and the user is author- 
ized for ALTER, that definition is deleted when the label is destroyed. If you do 
not want data management to perform this checking for you, you should insert 
your own label editor routine, as discussed under Chapter 6, “Volume Label 
Verification and Volume Label Editor Routines” on page 113. The various error 
conditions that can occur during verification of the first record are also 
explained under Chapter 6, “Volume Label Verification and Volume Label Editor 
Routines.” 


Bypass Label Processing (BLP) Option 
| If you do not want data management to check an output tape for an existing 
standard label, you must specify BLP (instead of NL) in the LABEL parameter of 
the DD statement. In all other respects, tape processing under BLP is the same 
as if NL were specified. For the method of specifying BLP for the JES reader, 
see JES2 Initialization and Tuning or JES3 Initialization and Tuning. 7 


The BLP option is designed mainly to process blank (unused) tapes. You may 
want to write a tapemark, data, or a label on the blank tape. If BLP is not 
coded, data management will read through an entire blank tape looking for the 
first record. 


There are other reasons for using the BLP option. For example, you may want 
to overwrite a 7-track tape that differs from your current parity or density spec- 
ifications. If such a tape is mounted, data management makes 4 attempts to | 
read the initial record (to determine that it is not an IBM standard label) before he 
accepting the tape. Each read may result in a long error recovery attempt. 

You can eliminate the 4 read operations by specifying BLP instead of NL. 


If an installation plans to use RACF protection for tape volumes or password 
protection for tape data sets, the BLP JCL option must either be disallowed 
completely, or restricted to authorized users. The BLP option is associated 
with jobclass; that is, the installation has the option to allow or disallow BLP by 
jobclass. It is recommended that BLP be disallowed completely, or if this is not 
possible, that one jobclass be set aside as the “BLP” and controlling class. 
This can be done by using JES initialization options to allow BLP for only that ae 
controlling class and by using installation JCL exits to force TYPERUN = HOLD 

for all jobs specifying that class. The system operator can then monitor that 

class and release only jobs authorized to use BLP. 


Volume Serial Number 
You are not required to specify volume serial numbers for unlabeled output 
tapes. If none is specified, the mount message directs the operator to mount a 
scratch tape. | 


If you request a specific volume, the operating system uses the specified 
volume serial number for mounting messages, for cataloging, and for passing 
the volumes to other job steps. 





If you do not request a specific volume, the system cannot obtain the actual 
serial number of the volume that is mounted. In this case, the system gener- 
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ates a volume serial number and assigns it to the volume. These volume serial 
numbers are generated in the form Lxxxyy, where: 


XXX 
( - is a number the open routine increments (by one) each time an output data 
set is opened on a nonspecified unlabeled volume. If more than one data 
set is created on the same volume, this number ts increased only when the 
first data set is opened. 


yy 
is set to 00 by the open routine. The EOV routine increments this number 


(by one) each time an end-of-volume condition occurs. In this way, each 
volume of a multivolume data set is assigned a different volume serial 
number. 


If a data set is to be cataloged, you should specify the volume serial numbers 
for all the volumes required. This prevents different data sets residing on dif- 
ferent volumes from being cataloged with identical volume serial numbers, 
which could result in the mounting of wrong volumes. 


Positioning the Volume to the Data Set 
When the tape is accepted for output, it is positioned to receive the new data 
set. Usually, the new data set is the first or only data set on the volume, so the 
tape is positioned at load point. 


To create a data set that follows another data set already stored on the volume, 
you specify a data set sequence number in the LABEL parameter of the DD 


statement. 
( : e The sequence number can be from 1 to 9999 with 1 representing the first 
data set on the volume. If you specify a sequence number that is 2 or more 


greater than the number of data sets existing on the volume, one of two 
things may happen: (1) the tape will be spaced through and removed from 
its reel, or (2) the data set will be written but separated from the preceding 
data set by unusable (old) data. 


e« If you do not specify a sequence number, or if you specify 0, data manage- 
ment assumes that the data set is to be written as the first one on the 
volume. 


( To position the tape, data management maintains a logical data set sequence 
number in the unit control block (UCB). The method of positioning is the same 
as that previously explained for opening an input data set. 


No more than one data set on a tape volume may be open at any given time. lf 
you attempt to open a second data set on the same volume, processing is 
abnormally terminated. 


End-of-Volume on Output 


Data management’s EQV routine automatically switches volumes when an end- 
of-volume condition occurs on output; that is, when the reflective strip is 
encountered at the end of a tape or when an FEOV macro instruction is exe- 
cuted. 
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The EOV routine writes one tapemark after the data set on the current volume 
and checks the new volume to ensure that it does not contain a standard 
volume label. The output is then continued on the new volume. 


Closing an Output Data Set 


The close routine handles end-of-data-set processing on output tapes. When a 
write operation is the last operation that occurs before closing a data set (for 
OUTPUT, OUTIN, or INOUT) or when no output is written before closing (for 
OUTPUT or OUTIN), the close routine creates data set trailer labels. 


Restarting from a Checkpoint 


When a job step is restarted from a checkpoint, the restart routine repositions 
any tape volumes containing data sets that were open when the checkpoint was 
taken. Specifically, the restart routine: 


1. Restores applicable control blocks to the conditions that existed when the 
checkpoint was taken. 


2. Ensures that the first existing record on the tape is not a standard volume 
label (VOL1). 


3. Uses the data set sequence number shown in the JFCB to position the tape 
at the required data set. The method of positioning is the same as previ- 
ously explained for opening an input data set. 


4. Uses the block count shown in the DCB to reposition the tape at the proper 
record within the data set. For forward read operations, this positioning is 
performed in a forward direction. If the block count is zero or negative, the 
tape remains positioned at the interrecord gap preceding the first record. 
For backward read operations, this positioning is performed in a backward 
direction. If the block count is 0 or a positive number, the tape is positioned 
at the interrecord gap following the last record of the data set. 
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- Chapter 6. Volume Label Verification and Volume Label 
( Editor Routines 





[_ Product-Sensitive Programming Interface 


This chapter contains product-sensitive programming interfaces provided by 
DFP. Installation exits and other product-sensitive interfaces are provided to 
allow the customer installation to perform tasks such as product tailoring, moni- 
toring, modification, or diagnosis. They are dependent on the detailed design 
or implementation of the product. Such interfaces should be used only for 
these specialized purposes. Because of their dependencies on detailed design 
and implementation, it is to be expected that programs written to such inter- 
faces may need to be changed in order to run with new product releases or 
versions, or as a result of service. 

( If you specify that an input or output tape has a standard label, the operating 
system checks for the standard volume label at the beginning of the tape. For 
ISO/ANSI/FIPS tapes, the system checks for the correct version. If you specify 
that the tape has nonstandard labels or no labels, the system attempts to verify 
that the first record is not a standard volume label. 


Because of conflicting label types or conflicting tape characteristics, various 
error conditions can occur during this verification of the first record. Under 
some error conditions, the tape is accepted for use. Under other error condi- 
( ' ie tions, the tape is not accepted and the system issues another mount message. 
For certain other error conditions, the system gives control to a volume label 
editor routine; your installation can use IBM-supplied routines or it can supply 
its own routines. 


The IBM-supplied volume label editor routines determine the discrepancies 
between the requested tape and the mounted tape and, if necessary, pass 
control to the appropriate data management routine to create or destroy labels, 
as required. Installation-supplied routines can perform other functions. 


( | If your installation supplies its own volume label editor routines, the first (or 
| only) module of each routine must be named as follows: 
¢ OMODVOL1 (for the editor routine associated with open) 
e EMODVOL1 (for the editor routine associated with EOV) 
If either of your installation’s editor routines consist of more than one load 
module, the names for the additional modules must begin with the prefix 


OMODVOL for the open routine, or EMODVOL for the EOV routine. Transfer 
between the modules must be by name. 


For detailed information about these and other available exit routines, see Data 
Facility Product: Customization. 


oe End of Product-Sensitive Programming Interface pal 
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Chapter 7. Using Tape Volumes Created by Other Systems 


Occasionally, it may be necessary to process a tape volume that was created 
by another system. There is no exact procedure: many of the factors vary 
according to the situation and the user’s options at the time the volume was 
created. The volume may be slightly or extremely different in its organization, 
its label formats, or its label contents. With the aid of this publication, a careful 
analysis of these factors will enable you to determine if the volume can be 
processed by your operating system. In some cases, certain modifications may 
be needed or restrictions observed. If tape volumes are to be transferred per- 
manently to the operating system, it is recommended that you use the oper- 
ating system to create new labels and volume organizations. 


abels 


All IBM programming systems create tape labels with the same standard label 
formats. However, the actual contents of each label field may vary from system 
to system. Figures 7, 8, and 9 show which fields of each label are functional for 
the operating system. Check the processing of these functional fields against 
the actual contents of the labels you want to use. This comparison should indi- 
cate whether the volumes are compatible or what modifications must be made. 


Special attention should be given to the data set identifier field of data set label 
1 (HDR1, EOV1, EOF1). The data set name in the label created by another 
system may contain embedded blanks or special characters. This name is 
compared to the data set name that you specify in the DD statement; therefore, 
you must enclose the name in apostrophes on the DD statement that requests 
this data set. JCL User’s Guide lists the restrictions that apply to enclosing a 
data set name in apostrophes. The apostrophes do not appear in the data set 
identifier field. 


To match the name in the label, you may have to madify the job file control 
block after the DD statement is recorded there. 


The operating system can obtain certain data set characteristics from the 
standard data set label 2 (HDR2/EOV2/EOF2). Some other IBM programming 
systems do not use or create data set label 2. The absence of data set label 2 
does not interfere with normal processing by the operating system, as long as 
the label information is specified by some other means. The functional informa- 
tion in data set label 2 (record format, block length, record length, tape 
recording technique, and printer control characters) can be furnished to the 
operating system either in the DCB macro instruction or the DD statement. 


Labels created by systems other than System/360, System/370, or 
system/370-XA programming systems should be treated as nonstandard labels, 
provided the first record on the tape is not identified as VOL1 and the data sets 
are followed by recognizable tapemarks. 


Chapter 7. Using Tape Volumes Created by Other Systems 115 





Nonstandard Labels 


Nonstandard labels are labels that do not conform to the formats described in fo ™ 
this manual. If you want to retrieve the data set and process the nonstandard Ss 
labels, you must write nonstandard label processing routines and insert them 

into the operating system. The procedure IS described under Chapter 4, “Non- 

standard Labels” on 1 page 103. | 


sees, 


If you want to ignore the nonstandard labels, you can retrieve the data set by 
treating the volume as an unlabeled tape. You use the data set sequence 
number in the DD statement to bypass the labels and beeon the tape to the 
data set. i. 25 es he 


Unlabeled Tapes 


The operating system can process unlabeled tape volumes created by other 
systems provided the data sets are followed by recognizable tapemarks. — jos 


To position a tape at the desired data set, you must specify the correct data set 
sequence number in the DD statement. If a tapemark precedes the first data 
set and the LABEL subparameter LTM ts specified, the system will test for and 
bypass, if present, a leading tapemark. If a tapemark should precede the first 
data set and you do not specify LTM in the LABEL parameter field, you mus! 
add 1 to the data set sequence number. 


If a multivolume data set from another system has a leading tapemark on one 
or more of the volumes, the operating system can process it as an unlabeled oe 
multivolume data set if the LABEL subparameter LTM is specified. Otherwise, ee 
the operating system cannot process it as an unlabeled multivolume data set. 


The presence of a leading tapemark, that is, a tapemark that precedes the first 
data set on the tape, makes each data set the second in sequence on the tape. 
However, the operating system always assumes that continued data sets are. 

first in sequence on the tape. By specifying LTM in the LABEL parameter field, 
the first data set on a tape can be accessed whether or not it is preceded by a 
leading tapemark. 


The specification of LTM in the LABEL parameter field does not make allow- | 
ances for any other excess tapemarks. You must make any such adjustments 
in the data set sequence number. 


SS were ot 
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Appendix A. Component Considerations 





Job control statements make the label processing facilities of data management 
available to users of the operating system’s assembler, linkage-editor, 
sort/Merge program product, utility programs, and high-level language program 
products. Figure 20 shows the component support for each type of label proc- 
essing. 


Assem- Linkage Sort/  Util- COBOL American 
Type bler Editor Merge’ ties National Standard FORTRAN PL/I RPG 
V2 V3 V4 
Uses Data 
Management 
Facilities 
for Label 
( Processing Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes 


Supports 

Standard 

Labels 

(SL,AL) Yes Yes Yes SL-Yes Yes Yes | Yes Yes Yes Yes 
AL-IEHINITT 


Supports 

Standard 

User 

Labels No No Yes Yes SUL-Yes SUL-Yes SUL-Yes No No No 
( (SUL, AUL) AUL-No  AUL-Yes AUL-Yes~ No No No 


‘Supports 

Nonstandard 

Labels 

(NSL) 2 Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes 


Supports 
Unlabeled 
Tape (NL) Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes 


Supports 
pe Bypass 
( Label 
: Processing 


Option 
(BLP) 2 Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes 


Supports 

Concate- 

nated Data 

Sets with 

Unlike | oe 

Attributes No Yes —s—.— No No No No No No No No 


1 NSL can be specified only when installation-written routines that write and 
process the nonstandard labels have been incorporated into the operating system. 


2 If the BLP option is not specified at system generation, its use defaults to NL. 


Figure 20. Component Support of Label Processing Types 
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Appendix B. External Labels 


- Reel Label 
( 
( Contents Label 





External labels are affixed to the tape reels to provide visual identification of the 
volume and its contents. Normal tape volume control requires two types of 
external tape labels. One is a permanent label that identifies the reel; the other 
is a temporary label that identifies the contents. A third type of label, the 
checkpoint security label, may be applied to tape reels that contain checkpoint 
data sets. 


To write on external labels, you should use an implement such as a penora 
felt-tip marker that does not produce loose residue. Do not use a lead pencil. 
Do not use an eraser. 


The reel label should be applied with a permanent-type adhesive, so that it 
cannot be easily removed. It is affixed when the tape is first received by your 
installation. The label should contain the sequential volume serial number 
assigned by your installation; it may also identify your installation. The volume 
serial numbers are used to identify the tape reel by a unique number and to file 
the tapes in the tape rack. An example of a reel label is shown in Figure 21. 


| XYZ Corporation 


San Jose, CA 


111125 


Figure 21. External Label for Reel Identification 





The contents label is used to identify the current contents of a particular 
volume. Because this is a temporary label, it should be applied with adhesive 
that is strong enough to hold the label securely and yet allow easy removal. 


This label is applied when data is written on the volume and contains identi- 
fying information to ensure that the contents of the volume can be easily distin- 
guishable from others. Your installation determines the format of the label. 
The information entered in the label is usually furnished partly by the pro- 
grammer and partly by the operator. Examples of contents labels are shown in 
Figure 22 on page 120. 
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REEL NUMBER PROGRAMMER'S NAME, DEPT., BLDG | 


/ 


SCRATCH DATE 


DENSIT¥ | PARITY| TRACK | TAPE DESCRIPTION 
\ 


Neem 
~ 


nen reine enetatn 


| DATE 





YSTEM | | | ; 
2 ae EL | CREATN 








Figure 22. External paid for Contents Identification 


Checkpoint Security Label 
A checkpoint security label may be put on tape volumes containing checkpoint 
data sets. This label, applied by the operator, helps ensure offline security of 
the checkpoint data set. For detailed information about the use of this label, Borde 
see Checkpoint/Restart User’s Guide. a 


The checkpoint security label is a temporary label; it should be applied with 
adhesive strong enough to hold the label securely and yet allow easy removal 
of the label later when the checkpoint data set is deleted. The size and place- 
ment of the label should not interfere with the handling of the tape. 
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Appendix C. 


Table Entry | 


Restart Work Areas 


[~~ Product-Sensitive Programming Interface —————— 


This appendix contains product-sensitive programming interfaces provided by 
DFP. Installation exits and other product-sensitive interfaces are provided to 
allow the customer installation to perform tasks such as product tailoring, moni- 
toring, modification, or diagnosis. They are dependent on the detailed design 
or implementation of the product. Such interfaces should be used only for 
these specialized purposes. Because of their dependencies on detailed design 
and implementation, it is to be expected that programs written to such inter- 
faces may need to be changed in order to run with new product releases or 
versions, or as a result of service. 


This appendix describes the restart table entry and the restart work and control 
block area. When your nonstandard label processing routine receives control 
from the control program’s restart routine, register 9 contains the starting 
address of the table entry associated with the data set. The TABSEGAD field of 


the table entry points to the starting address of the work and control block area 


associated with the same data set. 


Figure 23 shows the format of the restart table entry. A description of each 
field follows. 








































<4 Sa Sa ae eh ere ee aA YI OG acetone: uate re | 
——————————————————— 
(0) tappsora | 1 TABDCBAD 
wooo : seat sie pat an i ee 
4) TABFLG1 5(5) TABSEGAD 
Ne 
8) tapnvois — | 9) TABJFCB 
) ABTPLBL 1310.) aBrsano. | “© taBeLee ae TABFLG3 
440) ”SC«SYS)—t—t”:— wD —_ ~ 
10) ABELGA 71) ABEL GS WN) 
ps ate Tae a A a ea ete Jeeta sah a Mle Ae ct, See ate cela cee Sg ee ee le TABVL. | D 1 
DIB) : oe _ 
TABVLID2 Sap ae 1A 
sorte 
ee eee peste! TABVLID3 
36(24) 
TABVLIDA ee ees Soiiinae ose 
20) 
TABVLIDS 





Figure 23. Restart Table Entry Format 


Appendix C. Restart Work Areas 121 





Offset Field Name Bytes Description | 
0(0) TABDSORG 1 This field describes the data set organization used: 


a 
Bits Settings Meaning Ne. x 
0 de = Indexed sequential organization. 
1 1 Physical sequential organization. 
2 1 | Direct organization. 
3-5 Reserved for future use. 
6 1 Partitioned organization. 
7 1 Unmovable—the data set contains 
location-dependent information. 
1(1) TABDCBAD | 3 Address of the DCB | | 
4(4) TABFLG1 ~ { This field contains the following information: 
Bits Settings Meaning 
0 1 Data set was specified in DD statement es 
as NULLFILE or SYSCHECK. , ; 
1 1 Data set was specified in DD statement . 
as SYSIN or SYSOUT. 
2 { Device type = direct access. 
1 Device type = tape. 
4 1 This is the last table entry in the restart 
table. 
7 1 This is a DOS tape with an optional leading 
tape mark, and/or contains embedded DOS = 
checkpoint records. , 
5(5) TABSEGAD 3 Address of the restart work and control block areafor this data set. 
8(8) TABNVOLS 1 The total number of volumes for this data set, as specified in the DD 
statement. | 
9(9) TABJFCB 3 The relative track address (TTR) of the JFCB. 
12(C) TABTPLBL 1 This field contains the following tape label information: 
Bits Settings Meaning 
0 1 I/O error in NSL processing. dee 
1 Reserved. N / 
2 { Bypass a leading tape mark, if present, on 
an unlabeled tape. Bit 7 is also set. | 
3 1 Bypass label processing. 
4 1 ISO/ANSI/FIPS standard labels. 
5 1 Nonstandard labels. 
6 { IBM standard labels. 
7 1 No labels. 
13(D) TABFSQNO { Data set sequence number. 


14(E) TABFLG2 1 This field contains the following information: 
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Offset 








Field Name 


TABFLG3 
TABFLG4 
TABFLGS 
TABVLID1 


TABVLID2 
TABVLID3 
TABVLID4 
TABVLIDS 


Bytes 


Oo DD HD Ma 


Description 


Bits Settings Meaning 


0 1 More than five volumes associated with this 
data set. 

1 1 Partitioned organization concatenation. 

2-f Reserved 


Reserved for possible future use. 
Reserved for possible future use. 
Reserved for possible future use. 


The volume serial number of the first volume to be mounted for this 
data set. 


The volume serial number of the second volume. 
The volume serial number of the third volume. 
The volume serial number of the fourth volume. 


The volume serial number of the fifth volume. 
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Work and Control Block Area 
Figure 24 shows the format of the asian work and control block area. A Gr 


description of the control block fields follows. ey 










































































































































































Symbolic a . | | . 
Offset Black Name < : re 4 Bytes ——___________________________» 
i on = a eT a a aaa 4 Abbreviated 
O(0) RSDES — RSCEBTCBs—i—i(‘“‘i;™CS™SCCCir. +s OC ta Extent 
(48 bytes) A(4) RSDEBDEB Block 
3(8) RSDCB B(8)  RSDEBOFL | RSDESIRB | | Wits; 
WB byes) 730) RSDEBSYS | 
hs pe a ee NS se ee Rs te Br ee ee le tt 
- 16(10) RSDEBUSR 
20(14) RSDEBECB 
24(18) RSDEBID | . RSDESDCB 
28(1C) | RSDEBAPP. . 2 tS | 
7 nd ala COontro 
32(20) RS SDEBMOD RSDEBUCB | Block 
36(24) RSDEBBIN RSDEBSCC 
40(28) RSDEBSHH RSDEBECC jee 
AA(2C) RSDEBEHH. RSDEBNTR | “| J | - oF 
| sine bo od 
bas SECBAD _ ah | Event 
52(34) RSDCBDEB aes avy eles 
S&(38) RSIOB 56(38) RSIOBFG1 RSIOBFG2 | RSIOBSN1 RSIOBSN2 a 
vase) 80(3C) | —- RSIOBECB 
| 64(40) ee eS cas 
RSIOBCSW | | | 
72(48) RSIOBCPA | | Input/Output 
Pe et ae eee ee eee ee ea ot ieloek 
78(4C) RSIOBDCB | a 
80(50) ~ RSIOBRCP | | | | 
[eae RSIOBECT ae ee RSIOBINC , So 
88(58) 
RSIOBCDAD | 
fm in te Vv A 
98160) RSCCWLST | 96(60) 
(24 bytes) RSCCW1 
ee Channel 
104(68) RSccw? Program 
412(70) 
RSCCW3 | ee &, 
fre a ——= a” a. 
120(78) RSUBSEG ee 
(176 bytes) | | _L. | Job File Control 
T RSJFCB “| Block 
a a 
296(128) priate 296(128) RSSTAT1 RSSTAT2 | RSSTAT3 | RSSTAT4 
r Restart Status 
(8 bytes) 
B300012C) 12C) ne Reserved — =) Vv 








Figure 24. Restart Work and Control Block Area 
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aan hh Bb HL HL 
Oo mo © @© BH ND 


57(39) 


Field Name 
RSDEBTCB 
RSDEBDEB 
RSDEBOFL 
RSDEBIRB 
RSDEBSYS 
RSDEBUSR 
RSDEBECB 


RSDEBID 
RSDEBDCB 
RSDEBAPP 
RSDEBMOD 
RSDEBUCB 
RSDEBBIN 
RSDEBSCC 
RSDEBSHH 
RSDEBECC 
RSDEBEHH 
RSDEBNTR 
RSECBAD 
RSDCBDEB 
RSIOBFG1 


RSIOBFG2 


Bytes 


_ S&S fb fh WO = 


=~ hr WW 


Bm B® MO MPO NYO PP NY ND W 


aah 


Description 





Address of TCB for this DEB. 


Address of the next DEB in the same task. 


Data set status flags. 


IRB address used for appendage asynchronous exits. 
Address of first IOB in the system purge chain. 


Address of first IOB in the user purge chain. 


Address of a parameter list used to locate the purge ECB for an SVC 


purge request. 

A hexadecimal '0F' to identify this block as a DEB. 
Address of DEB associated with this DEB (RSDCB). 
Address of the I/O appendage vector table. 

Device modified. 

Address of UCB. 

Bin number of direct access volume (data cell drive). 
Cylinder address for start of an extent limit. 

Track address for the start of an extent limit. 
Cylinder address for the end of an extent limit. 
Track address for the end of an extent limit. 


Number of tracks allocated to a given extent. 


Event control block (ECB). 


Address of DEB associated with this DCB (RSDEB). 


Flag byte 1, as follows: 


Bits Settings 


0-1 00 
01 
10 
11 
2 1 
3 1 
4 1 
Ss) 1 
6 1 


Bits Settings 


7 0 


Meaning 


No chaining. 


Command chaining. 

Data chaining. 

Both command and data chaining. 
Error routine in control. 


Device is to be repositioned. 


Cyclic redundancy check (CRC) needed (tape only). 


Exceptional condition (if this bit is on 
after the error routine returns, the error is 
considered permanent). 


IOB unrelated flag (that is, nonsequential). 


Meaning 


Error recovery procedure uses channel 
program address a START (lOB + 17). 


RESTART error recovery procedure uses channel 


program address at IOBRESTR (1IOB + 24). 


Flag byte 2, as follows: 
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Offset 


104(68) 
112(70) 
( 
( 


78) 

296(128) 
297(129) 
298(12A) 
299(12B) 
300(12C) 


Field Name 


RSIOBSN1 


RSIOBSN2 
RSIOBECB 
RSIOBCSW 
RSIOBCPA 
RSIOBDCB 
RSIOBRCP 


RSIOBECT 
RSIOBINC 


RSIOBDAD 
RSCCW1 
RSCCW2 
RSCCW3 
RSJFCB © 
RSSTAT1 
RSSTAT2 
RSSTAT3 
RSSTAT4 


Bytes 


Oo + Sf HR CO A 


RO 


Co Ceo CO © 


176 


Description . 


Bits Settings Meaning 


0 1 Halt I/O has been issued. 
1 1 Sense will not be performed until the device is free. 
2 1 lIOB has been purged. 
1 Home address (RO) record is to be read. 
4-6 (variable) Internal I/O supervisor error 
correction flags. 
7 1 QSAM—error recovery in control for an 


IBM 2540 Card Read Punch with three buffers. 
First sense byte (device-dependent). 
Second sense byte (device-dependent). 
Address of the ECB to be posted (RSECBAD). 
CSW. 
Address of the channel program to be executed (RSCCW1). 
Address of the DCB associated with this IOB (RSDCB). 


Restart address used by |/O supervisor error routines during error cor- 
rection. 3 


Value used to increase block count field in DCB for magnetic tape. 


Used by I/O supervisor error routines to count temporary errors during 
retry. 


This field is used for direct access only. 
Channel program area. 

Channel program area. 

Channel program area. 

Work area for job file control block. 
Status byte 1. 

Reserved for possible future use. 
Reserved for possible future use. 
Reserved for possible future use. 


Reserved for possible future use. 


End of Product-Sensitive Programming Interface searched teste 
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Appendix D. Version 3 Installation Exits 


| Product-Sensitive Programming Interface | 


This appendix contains product-sensitive programming interfaces provided by 
DFP. Installation exits and other product-sensitive interfaces are provided to 
allow the customer installation to perform tasks such as product tailoring, moni- 
toring, modification, or diagnosis. They are dependent on the detailed design 
or implementation of the product. Such interfaces should be used only for 
these specialized purposes. Because of their dependencies on detailed design 
and implementation, it is to be expected that programs written to such inter- 
faces may need to be changed in order to run with new product releases or 
versions, or as a result of service. 


Four installation exits are provided, as defaults, for Version 3 volumes: 
« Volume access, 
e File access, 
e Label validation, and 
e Label validation suppression. 


A fifth installation exit, WTOR, can be written (or modified, if one has already 
been written) by your installation to convert ISO/ANSI/FIPS non-Version 3 to 
Version 3 labels. 


All the default installation exit routines are supplied in a module containing a 
single CSECT (IFG0193G, alias IFGO553G), in SYS1.LPALIB. A copy of the 
source code for the module is contained in member ANSIEXIT of 
SYS1.SAMPLIB. 


The default routines, except the validation suppression exit, reject the volume. 
They execute in a privileged (Supervisor) state and can be modified or replaced 
to perform I/O (such as overwriting a label), change system control blocks, and 
mount or demount volumes. The return code from the exits may be modified to 
request continued processing. However, results are unpredictable in cases in 
which the label validation exit is entered and it has not been modified to also 
correct certain errors. 


You can replace any of the IBM-supplied exit routines with your own, 
installation-written, exit routines. 


For detailed information about these and other available exit routines, see Data 
Facility Product: Customization. 


ee End of Product-Sensitive Programming Interface i 
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-~ Appendix E. Equivalent ISCII/ASCII, EBCDIC, and Hollerith 
( Codes 


ISCII/ASCII 7-Bit Code 


The translate routine included in the system at system generation time trans- 
lates ISCII/ASCII 7-bit code to and from EBCDIC. 


All EBCDIC codes that translate to an ISCII/ASCII code that cannot be contained 
in seven bits are represented by the substitute character X'1A' 


ISCII/ASCIl 8-Bit Code 


( You may replace the IBM-supplied translation routine with an installation- 
: written routine that translates ISCII/ASCII 8-bit code. Note, however, that such 
a modification will result in a volume that does not meet Version 3 standards, 
and therefore would require agreements between interchange parties. 


The following tables show the relationship of EBCDIC and Hollerith code to 
ISCII/ASCII 8-bit code. 


EBCDIC to Hollerith and ISCII/ASCII 


( . ISCIL/ ISCII/ 


EBCDIC HOLLERITH ASCII EBCDIC HOLLERITH ASCil 

(hex) (punches) (hex) (hex) (punches) (hex) 
00 12-0-9-8-1 00 14 11-9-4 9D 
01 2-9-1 01 15 11-9-5 85 
02 42-9-2 02 16 11-9-6 08 
03 12-9-3 03 17 11-9-7 87 
04 42-9-4 9C 18 11-9-8 18 
( 05 12-9-5 09 19 11-9-8-1 19 
K 06 12-9-6 86 1A 11-9-8-2 92 
07 12-9-7 7F 1B 11-9-8-3 8F 
08 12-9-8 97 1C 11-9-8-4 1C 
0g 12-9-8-1 8D 1D 11-9-8-5 1D 
OA 12-9-8-2 8E 1E 11-9-8-6 1E 
OB 412-9-8-3 OB 1F 11-9-8-7 1F 
OC 12-9-8-4 OC 20 11-0-9-8-1 80 
OD 12-9-8-5 OD 21 0-9-1 81 
OE 42-9-8-6 OE 22 0-9-2 82 
OF 12-9-8-7 OF 23 0-9-3 83 
10 12-11-9-8-1 10 24 0-9-4 84 
11 11-9-1 11 25 0-9-5 OA 
12 11-9-2 12 26 0-9-6 17 
13 11-9-3 13 27 0-9-7 1B 
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| ISCII/ | ae ISCII/ 
EBCDIC HOLLERITH ASCII &. a EBCDIC HOLLERITH ASCII 
(hex) (punches) (hex) (hex) (punches) (hex) 
28 0-9-8 88 55 42-11-9-5 © AD 
29 0-9-8-1 89 56 12-11-9-6 AE 
2A 0-9-8-2 8A 57 42-11-9-7 AF 
2B 0-9-8-3 8B 58 12-11-9-8 | BO 
2C 0-9-8-4 8C 59 11-8-1 B1 
2D 0-9-8-5 05 5A 11-8-2 5D 
2E 0-9-8-6 06 5B 11-8-3 24 
OF 0-9-8-7 07 5C 11-8-4 2A 
30 12-11-0-9-8-1 90 5D 11-8-5 29 
31 9-4 94 5E 11-8-6 3B 
32 9-2 16 5F 41-8-7 5E 
33 9-3 93 60 11 2D 
34 9-4 94 61 0-1, 2F Me 
35 9-5 95 62 11-0-9-2 B2 — 
36 9-6 96 63 11-0-9-3 B3 “Ge 
37 9-7 04 64 11-0-9-4 B4 
38 9-8 98 65 11-0-9-5 B5 
39 9-8-1 9g 66 11-0-9-6 B6 
3A 9-8-2 9A 67 11-0-9-7 B7 
3B 9-8-3 9B 68 11-0-9-8 B8 
3C 9-8-4 14 69 0-8-1 B9 
3D 9-8-5 15 6A 12-11 ss Je 
3E 9-8-6 9E 6B «0-8-3 2C 7 
3F 9-8-7 1A 6C 0-8-4 25 ad 
AO (none) 20 6D 0-8-5 5F 
At 12-0-9-1 AO 6E 0-8-6 3E 
A2 12-0-9-2 At 6F 0-8-7 3F 
43 12-0-9-3 A2 70 12-11-0 BA 
A4 12-0-9-4 A3 71 12-11-0-9-1 BB 
45 42-0-9-5 A4 72 42-11-0-9-2 BC 
46 12-0-9-6 AS 73 12-11-0-9-3 BD 2%, 
47 12-0-9-7 AG 74 12-11-0-9-4 BE —- 
48 12-0-9-8 A7 75 12-11-0-9-5 BF bead 
49 12-8-1 A8 76 12-11-0-9-6 CO 
AA 12-8-2 5B 77 42-11-0-9-7 C1 
4B 12-8-3 2E 78 12-11-0-9-8 C2 
AC 12-8-4 ac | 79 8-1 60 
AD 12-8-5 28 7A 8-2 3A 
4E 12-8-6 2B 7B 8-3 23 
AF 2-8-7 21 7C 8-4 40 
50 12 26 7D 8-5 27 
51 12-11-9-1 Ag . 7E 8-6 | 3D 
52 12-11-9-2 AA | 7F 8-7 22 
53 12-11-9-3 AB | 80 12-0-8-1 C3 
54 12-11-9-4 AC | 81 12-0-1 61 
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| ISCII/ Sgt ee ISCII/ 
EBCDIC HOLLERITH ASCII EBCDIC HOLLERITH ASCII 
( ’ (hex) (punches) (hex) (hex) (punches) (hex) 
82 12-0-2 62 | AF 11-0-8-7, D7 
83 12-0-3 63 Bo 12-11-0-8-1 D8 
84 12-0-4 64 B1 12-11-0-1 Dg 
85 42-0-5 65 B2 12-11-0-2 DA 
86 12-0-6 66 B3 12-11-0-3 DB 
87 42-047 67 B4 12-11-0-4 DC 
88 12-0-8 68 B5 12-11-0-5 DD 
89 12-0-9 69 B6 12-11-0-6 DE 
8A 12-0-8-2 C4 B7 42-11-0-7 DF 
8B 12-0-8-3 C5 B8 12-11-0-8 EO 
8C 12-0-8-4 C6 | B9 412-11-0-9 E1 
8D 12-0-8-5 G7 BA 12-11-0-8-2 E2 
- 8E 12-0-8-6 C8 BB 12-11-0-8-3 E3 
( | 8F 1220:8:7 cg BC 12-11-0-8-4 E4 
. 90 12-11-8-1 CA BD 12-11-0-8-5 E5 
91 12-11-1 6A BE 12-11-0-8-6 E6 
92 12-11-2 6B BF 12-11-0-8-7 E7 
93 12-11-3 6C CO 12-0 7B 
94 12-11-4 6D C1 42-1 A1 
95 12-11-5 6E C2 12-2 42 
96 | 12-11-6 - 6F testis uct tea dy .,. A220". 43 
7 7 97 = 12-11-7 70 C4 12-4 44 
( . QB 12-41-8- | 71 C5 12-5 45 
| _ 99 12-11-9 72 Cb 12-6 AG 
9A 12-11-8-2 CB C7 12-7 47 
9B 12-11-8-3 CE C8 12-8 48 
gC 12-11-8-4 CD Cg 12-9 49g 
9D 12-11-8-5 CE CA 12-0-9-8-2 E8 
SE 12-11-8-6 CF CB 12-0-9-8-3 EQ 
OF 42211-6-7 DO CC 12-0-9-8-4 EA 
_ AO 11-0-8-1 D1 CD 12-0-9-8-5 EB 
( AM 11-0-1 7E | CE 12-0-9-8-6 EC 
A2 11-0-2 73 | CF 12-0-9-8-7 ED 
A3 11-0-3 74 DO 11-0 7D 
A4 11-0-4 75 D1 11-1 4A 
A5 11-0-5 76 D2 41-2 4B 
AG 11-0-6 ve — D3 11-3 AC 
A7 11-0-7 78 D4 11-4 AD 
A8 11-0-8 79 D5 11-5 AE 
AQ 11-0-9 7A D6 11-6 AF 
AA 11-0-8-2 D2 D7 11-7 50 
AB 11-0-8-3 D3 | D8 11-8 51 
AC 11-0-8-4 D4 | Dg 11-9 52 
AD 11-0-8-5 D5 DA 42-11-9-8-2 EE 
( AE 11-0-8-6 D6 DB 12-11-9-8-3 EF 
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EBCDIC HOLLERITH 


(hex) 


DC 
DD 
DE 
DF 
EO 


E1 
E2 
E3 
E4 
ES 


E6 
E7 
E8 
E9 
EA 


EB 
EC 
ED 
EE 
EF 


FO 
F1 
F2 
F3 
F4 


FS 
F6 
F7 
F8 
FQ 


FA 
FB 
FC 
FD 
FE 


FF 
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(punches) 

12-11-9-8-4 

12-11-9-8-5 

12-11-9-8-6 

12-11-9-8-7 

0-8-2 

11-0-9-1 

0-2 

0-3 

0-4 

0-5 

0-6 

0-7 

0-8 

0-9 

11-0-9-8-2 

11-0-9-8-3 
—11-0-9-8-4 

11-0-9-8-5 

11-0-9-8-6 

11-0-9-8-7 

0 

4 

2 

3 

4 

5 

6 

7 

8 

g 

12-11-0-9-8-2 

12-11-0-9-8-3 

12-11-0-9-8-4 

12-11-0-9-8-5 

12-11-0-9-8-6 

12-11-0-9-8-7 


ISCII/ 
ASCII 


(hex) | 
FO! 


F1 


Fe 
F3 


oC 


OF 
53 
54 


"#90 


56 


57 
58 
59 
5A 
F4 


FS 
F6 
F/7 
F8 
F9 


30 
31 
32 
33 
34 


35 
36 


387 


38 
39 


FA 
FB 
FC 
FD 
FE 


FF 

















ISCII/ASCII to EBCDIC and Hollerith 


( | ISCII/ | ISCII/ 7 , 
ASCII HOLLERITH EBCDIC ASCII HOLLERITH EBCDIC 
(hex) (punches) (hex) | (hex) (punches) (hex) 

00 12-0-9-8-1 00 2D 11 60 

01 2-9-1 01 2E 2-8-3 4B 

02 12-9-2 02 QF 0-1 61 

03 12-9-3 03 30 0 FO 

04 9-7 37 31 1 F4 

05 0-9-8-5 2D | 32 2 F2 

06 0-9-8-6 2E 33 3 F3 

07 0-9-8-7 QF 34 4 F4 

08 11-9-6 16 35 5 F5 

09 12-9-5 05 36 6 F6 

ste OA 0-9-5 25 37 7 F7 

OB 12-9-8-3 0B 38 8 F8 

oc 12-9-8-4 oc 39 g Fg 

OD 12-9-8-5 OD 3A 8-2 7A 

OE 12-9-8-6 OE 3B 11-8-6 5E 

OF 12-9-8-7 OF 3C 12-8-4 AC 

10 12-11-9-8-1 10 3D 8-6 7E 

11 411-9-1 11 3E 0-8-6 6E 

12 11-9-2 42 3F 0-8-7 6F 

| 13 11-9-3 13 40 8-4 7C 

( 14 9-8-4 3C 41 12-1 C1 

15 9-8-5 3D 42 12-2 C2 

16 9-2 32 43 12-3 C3 

17 0-9-6 26 44 12-4 C4 

18 11-9-8 18 45 12-5 C5 

19 11-9-8-1 19 AG 12-6 C6 

1A 9-8-7 3F 47 12-7 C7 

1B 0-9-7 27 48 12-8 C8 

~ 1C 11-9-8-4 1C 4g 12-9 Cg 

( 1D 11-9-8-5 1D AA 11-1 D1 

1E 11-9-8-6 1E 4B 11-2 D2 

1F 11-9-8-7 4F | | AC 11-3 D3 

20 (none) 40 4D 11-4 D4 

21 12-8-7 4F AE 11-5 D5 

22 8-7 7F AF 11-6 | D6 

23 8-3 7B 50 11-7 D7 

24 11-8-3 5B 51 11-8 D8 

25 0-8-4 6C 52 11-9 pg 

26 12 50 53 0-2 E2 

27 8-5 7D 54 0-3 E3 

28 12-8-5 4D 55 0-4 E4 

: 29 11-8-5 5D 56 0-5 E5 

( - 2A 412824 5C 57 0-6 E6 

ea 2B 12-8-6 4E 58 0-7  E7 


2c 0-8-3 6B 59 0-8 E8 
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ISCII/ ISCII/ 





ASCII HOLLERITH EBCDIC | ASCII HOLLERITH EBCDIC 

(hex) (punches) (hex) (hex) (punches) (hex) 

5A 0-9 EQ 87 11-0:57 17 

5B 12-8-2 AA 7 88 0-9-8 28 

5C 0-8-2 50 89 0-9-8-1 29 

5D 11-8-2 5A 8A 0-9-8-2 2A 

5E 446-7 5F 8B 0-9-8-3 2B 

5F 0-8-5 6D | 8C 0-9-8-4 9C 

60 8-1 79 8D 12-9-8-1 09 

61 12-0-1 81 8E 42-9-8-2 OA 

62 12-0-2 82 | 8F 41-9-8-3 1B 

63 12-0-3 83 90 12-11-0-9-8-1 30 

64 12-0-4 84 91 9-1 31 

65 2-0-5 85 92 11-9-8-2 1A 

66 12-0-6 86 93 9-3 33 7 
67 49-07 87 94 9-4 34 i 
68 12-0-8 88 95 9-5 35 no 
69 12-0-9 89 96 9-6 36 

6A 12-11-1 91 97 12-9-8 08 

6B 49-4420 92 | 98 9-8 38 

6C 42-11-3 93 99 9-8-1 39 

6D 12-11-4 94 9A 9-8-2 3A 

6E 12-11-5 95 9B 9-8-3 3B 

6F 12-11-6 96 9C 12-9-4 04 | a 
70 12-11-7 97 9D 11-9-4 14 a 
71 12-11-8 98 9E 9-8-6 3E ad 
72 12-11-9 99 OF 11-0-9-1 E1 

73 11-0-2 AQ AO 12-0-9-1 AY 

74 11-0-3 A3 } Al 42-0-9-2 42 

75 11-0-4 A4 A2 12-0-9-3 43 

76 11-0-5 A5 A3 12-0-9-4 44 

77 11-0-6 Ab A4 12-0-9-5 45 

78 11-0-7 A7 A5 12-0-9-6 46 a 
79 11-0-8 A8 A6 12-0-9-7 47 
7A 11-0-9 AQ AT 12-0-9-8 48 “= 
7B 12-0 CO A8 2-8-1 49 

7C 12-11 6A | AQ 12-11-9-1 51 

7D 11-0 DO AA 12-11-9-2 52 

7E 41-0-1 A1 AB 49-41-9283 53 

7F 2-9-7 07 | AC 12-11-9-4 54 

80 41-0-9-8-1 90 AD 42-41-9-5 55 

81 0-9-1 oy AE 42-11-9-6 56 

82 0-9-2 29 | AF 12-11-9-7 57 

83 0-9-3 93 BO 42-11-9-8 58 

84 0-9-4 24 B1 11-8-1 59 

85 1-9-5 45 B2 11-0-9-2 62 

86 12-9-6 06 B3 11-0-9-3 63 F a 
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ISCII/ . ISCII/ 


ASCII HOLLERITH —= EBCDIC ASCII HOLLERITH EBCDIC 
( - (hex) (punches) (hex) (hex) (punches) (hex) 
B4 11-0-9-4 64 E1 12-11-0-9 B9 
B5 11-0-9-5 65 E2 12-11-0-8-2 BA 
B6 11-0-9-6 66 E3 12-11-0-8-3 BB 
B7/ 11-0-9-7 67 E4 12-11-0-8-4 BC 
B8 11-0-9-8 68 E5 12-11-0-8-5 BD 
B9 0-8-1 69 E6 12-11-0-8-6 BE 
BA 12-11-0 70 E/ 12-11-0-8-7 BF 
BB 12-11-0-9-1 71 E8 12-0-9-8-2 CA 
BC 12-11-0-9-2 72 E9 12-0-9-8-3 CB 
BD 12-11-0-9-3 73 EA 12-0-9-8-4 CC 
BE 42-11-0-9-4 14 EB 12-0-9-8-5 CD 
BF 12-11-0-9-5 15 EC 12-0-9-8-6 CE 
a CO 412-11-0-9-6 76 ED 12-0-9-8-7 CF 
( | C1 12-11-0-9-7 7 EE 12-11-9-8-2 DA 
. C2 {2-11-0-9-8 18 EF 12-11-9-8-3 DB 
C3 12-0-8-1 80 FO 12-11-9-8-4 DC 
C4 12-0-8-2 8A F1 12-11-9-8-5 DD 
C5 12-0-8-3 8B F2 12-11-9-8-6 DE 
C6 12-0-8-4 8C F3 12-11-9-8-7 DF 
C7 12-0-8-5 8D F4  —-11-0-9-8-2 EA 
C8 12-0-8-6 8E Fo 11-0-9-8-3 EB 
co cg 12-0-8-7 8F F6 11-0-9-8-4 EC 
( CA 12-11-8-1 90 F?/ 11-0-9-8-5 ED 
CB 12-11-8-2 9A F8 11-0-9-8-6 EE 
CC 12-11-8-3 9B F9 11-0-9-8-7 EF 
CD 12-11-8-4 9C FA 12-11-0-9-8-2 FA 
CE 42-11-8-5 9D FB 12-11-0-9-8-3 FB 
CF 12-11-8-6 QE FC 12-11-0-9-8-4 FC 
DO 12-11-8-7 OF FD 12-11-0-9-8-5 FD 
D1 11-0-8-1 AO FE 12-11-0-9-8-6 FE 
‘a D2 11-0-8-2 AA FF 42-11-0-9-8-7 © FF 
( D3 11-0-8-3 AB 
D4 11-0-8-4 AC 
D5 11-0-8-5 AD 
D6 11-0-8-6 AE 
D7 11-0-8-7 AF 
D8 12-11-0-8-1 BO 
D9 12-11-0-1 B1 
DA 12-11-0-2 B2 
DB 12-11-0-3 B3 
DC 12-11-0-4 B4 
DD 12-11-0-5 B5 
DE {2-11-0-6 B6 
DF 12-11-0-7 B/ 
EO 12-11-0-8 B8 
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Translation Irregularities 


Six irregularities exist in the graphic character set between ISCII/ASCII /-bit 
code, ISCII/ASCII 8-bit code, and EBCDIC. These are: 





EBCDIC Code Bit Code 7-Bit Code 
Graphic) (Hex) Graphic) (Hex Graphic) (Hex 
¢ 4A [ 5B ] 5B 
5A ] 5 ] 5D 
Te AD (n/a) D5 Sub 1A 
] BD (n/a) E5 Sub 1A 
| 4F 21 ! 21 aX 


| 6A | 7C | 7C 


Thus, for example, an exclamation mark is coded in EBCDIC as X'5A', but in 
ISCII/ASCII 7-bit and 8-bit codes as X'21' 
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Index 


A 


accessibility field 
in ANSI data set 1 label 66 
in ANSI standard data set label 1 94 
in ANSI standard volume label 88 
in ANSI VOL1 label 65 
ANSI standard labels 
compared to IBM standard labels 59 
component support 117 
definition 59 
header labels 63 
See a/so data set label 1, data set label 2 
operating system support 56 
overview of processing 68 


protecting data through volume accessibility 64 


specification of 1 
tapemarks with 64 
trailer labels 64 
See afso data set label 1, data set label 2 
types of 59 
Version 1 
definition of 55 
Version 3 
definition of 55 
installation exits 127 
processing on other MVS systems 59 
volume label 
creation of 63, 79 
definition of 63 
format of 86-89 
processing of 69 
volume organization with 61 
ASCII interchange tape 
conversion from EBCDIC 56, 129 
operating system Support 956 
assembler support 117 
assigning volume serial numbers 
in JCL statements 38-39, 88 
system assignments 110 
using IEHINITT utility program 38—39, 88 
automatic volume recognition 
See AVR 
AVR (automatic volume recognition) 
explained 8 
with 7-track tapes 11 


B 
backward read 

See RDBACK parameter 
basic tape formats 1—2 
binary data 10 


bits per inch (densities) 9-12 
blank tape 

bypass label processing 110 

IEHINITT utility 

with ANSI standard labels 80 
with IBM standard labels 27 

block count 

in ANSI standard data set label 1 94 

with ANSI standard labels 73, 76 

with IBM standard labels 22, 23, 45 
block length 22, 49 

in ANSI standard data set label 2 98 
BLP subparameter 2, 110 
buffer alignment block 

in ANSI standard data set label 2 100 
buffer offset 

in ANSI standard data set label 2 100 
bypass label processing 

component support of 117 

specification of 2 

using 110 


C 


cataloged data sets 
explained 4 
with ANSI standard labels 77 
with generation groups 5 
with IBM standard labels 20, 24 
with ISO/ANSI/FIPS standard labels 71 
with no labels 106 
channel status word (CSW) 12 
character code, EBCDIC 10 
checking volume labels 113 
checkpoint/restart 
See restart routine 
CLOSE macro 
for ANSI standard labels 79, 86 
for IBM standard labels 27, 34 
for nolabels 112 
function of 7 
close routine 
for ANSI standard labels 79, 86 
for IBM standard labels 27, 34 
for nolabels 112 
function of 7 
closing an input data set 
with ANSI standard labels 79 
with IBM standard labels 27 
with no labels 108 
closing an output data set 
with ANS! standard labels 86 
with IBM standard labels 34 
with no labels 112 
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COBOL 117. | | _ data set label 1 (HDR1, EOV1, EOF1) (continued) 





completing the data control block 3-4 IBM standard 
component support 117 contents of 40-46 | o~ 
concatenation 7 definition of 13-15 a / 
data sets format of 40—46 
explained 5 oe | 7 in other systems 115 
with ANSI standard labels 66, 75, 78 processing of 17-35, 40—46 
with IBM standard labels 23, 26 | data set label 2 (HDR2, EOV2, EOF2) 
with no labels 108 | ANSI standard 
connected data sets contents of 95-100 
See concatenation, data sets | definition of 55—64 
contents label 119-120 format of 95-100 
control characters processing of 69, 75, 95, 100 
for ANSI standard label 99 | writing 83, 84 
for IBM standard labels 23,50 IBM standard 
conversion contents of 46—51 
data : | definition of 13-15 
ASCII. to/from EBCDIC 56, 129 format of 46—51 
BCD to/from EBCDIC 10 | in other systems 115 
creating a volume label | processing of 17—35, 46—51 yore 
ANSI standard volume labels 79 data set name | 
IBM standard volume labels 27 in ANSI standard labels *S. 
nonstandard volume labels 103 checking before input processing 72 
creation date | checking before output processing 67 
for IBM standard labels 44 duplicate name checking 73 
in ANSI standard data set label 1 93 format in HDR1 label 91 
CSW (channel status word) 12 in IBM standard labels 
checking before input processing 23 
, checking before output processing 31-33 
D format in HDR1 label 42 
data control block . in other systems 115 oe 
See DCB | data set position - 
data conversion 10, 56, 129 ANSI standard labeled tapes 2, 99 Ke «67 
data group index 5 IBM standard labeled tapes 2, 49 
data management 7 data set protection 57 
data recording characteristics 9-12 of multiple volumes 
data set a . with ANSI standard labels 78 
attributes 3-7 with IBM standard labels 25—26 
cataloged 4 | processing of 
concatenated with ANSI standard labels 80 
description 95 | with IBM standard labeled tapes 19, 34, 44—46 
with ANSI standard labels 78 | | specification of 3 
with IBM standard labels 26 with ANSI standard labels 64 a 
generation 9 data set sequence number a, 
multiple per volume 6 default 3 a 
multiple volumes per data set 6, 24—26, 77-78, for concatenated data sets 
85 with ANSI standard labels 78 
passed 6 with IBM standard labels 26 
processing methods 7 for multiple volumes 
data set header labels with ANSI standard labels 78 
ANSI standard labels 63 with IBM standard labels 26 
IBM standard labels 16-17 for repositioning during Restart 35 
data set identifier 42 for SYSOUT data sets 29 
data set label 1 (HDR1, EOV1, EOF1) in other systems 116 
ANSI standard | specification of 3 
contents of 89-95 | with ANSI standard labels 71, 82, 85 
definition of 55—64 explained 92 
format of 89--95 with IBM standard labels 20, 29, 43 
processing of 69, 89-95 
writing 83 
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data set sequence number (continued) 
with no labels 106, 111 
data set serial number 
for ANSI standard labels 
See file set identifier 
for IBM standard labels 43 
DCB exit routine 4 
DCB macro 
completing the data control block 3-4 
DEN parameter for 9-12 
TRTCH parameter for 11 
DCB (data control block) 
completion 3—4 
end-of-data routine 
with ANSI standard labels 75-78 
with IBM standard labels 23-26 
with no labels 108 
user label (ANSI) exits 75, 84 
user label (IBM) exits 23, 24, 33, 35 
DD statement 
DCB parameter 5 
DEN parameter 9-12 
DISP parameter 8 
for concatenated data sets 5 
for multiple data sets 6—7 
for multiple volumes 6 
for passed data sets 6 
LABEL parameter 2 
TRTICH parameter 11 
VOLUME parameter 6 
DDR (dynamic device reconfiguration) option 103 
deferred user trailer label processing 
with ANSI standard labels 75 
with IBM standard labels 18, 33-34 
DEN parameter 9-12 
density 
ANSI standard labels 99 
conflicts, how resolved 9 
DEN parameter codes 11 
IBM standard labels 49 
describing data sets 
LABEL parameter 2-3 
physical attributes 3 
volume and unit information 3 
describing labels 2-3 
DISP parameter 8 
disposition of volumes, positioning parameters 
explained 8 
dual density 9 
dummy header label 
for ANSI standard labels 79, 83 
for IBM standard labels 27 
dynamic device reconfiguration (DDR) option 103 


E 


editor routines, volume label 113 
module names 113 


EMODVOL1 113 
end of data set 
explained 7 
with ANSI standard labels 75-78 
with IBM standard labels 23-26 
with no labels 108 
end of reel 12 
end of volume 
explained 7 
special conditions 34, 85 
with ANSI standard labels 75-78, 84—85 
with IBM standard labels 23-25, 33-34 
with no labels 108 
end-of-data routine 
See EODAD routine 
EODAD (end-of-data) routine 
explained 7 
for ANSI standard labels 75-78 
for IBM standard labels 23-26 
for no labels 108 
EOV macro 7 
EOV routine 
for ANSI standard labels 75-78, 84—85 
for IBM standard labels 23-25, 33-34 
for no labels 108 
OPTCD=B_ 42, 91 
EOV 1 label 
See data set label 1 
EOV 2 label 
See data set label 2 
EOV, volume label editor routine 113 
error 
permanent I/O 
with ANSI standard labels 84 
exit routine 
open/EOV user exit for nonspecific tape mount 
requests 28 
open/EOV user exit for security verification 22, 
26, 31, 33 
Version 3 127 
expiration date 
in ANSI standard data set label 1 93 
in LABEL parameter 3 
with ANSI standard labels 73, 83 
with IBM standard labels 22, 44 
external labels 119-120 


F 
FEOV macro 
with ANSI standard labels 
input tape 75 
output tape 75, 84 
with IBM standard labels 
input tape 18, 23-24, 27 
output tape 18, 33 
with no labels 108, 111 
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file identifier 


in ANSI standard data set label 1 91 ~ 


file section number 


in ANSI standard data setlabel 1 92_ 


file sequence number 
See a/so data set sequence number 
in ANSI standard data’ sk label 1 92 
file set identifier 
in ANSI standard data set label 1 92 
first record, verification of | 
bypass label processing 110 
for ANSI standard labels 70, 78 
for IBM standard labels 19, 25 
for no labels 106, 109 
for nonstandard labels 103 
format 
data set labels 
ANSI! standard labels 89~—100 
IBM standard labels 40—46, 51 
user labels 
ANSI standard labels 100-102 
IBM standard labels 52—53 
FORTRAN) 117 | 
forward merge of the DCB 4 


G 


generation data group 

explained 5 

with ANSI standard labels 92 

with IBM standard labels 43 
generation numbers 

explained 95 

in ANSI standard data set label 1 92. 

in IBM standard labels 43 . 


H 
HDR1 label 
See data set label 1 
HDR2 label 
See data set label 2 
header label 
ANSI identifiers for 60 
definition of 1 
IBM identifiers for 13 
high speed search, 3480 tape volume 30 


l 

IBM standard labels 115 
component support 117 > 
definition 1, 13 
Operating system support 13 
overview of processing 17-19 
specification of 1 . 
types of 13 
volume layouts for 13-15 


IBM 3480 Magnetic Tape Subsystem 28 
IBM 3480 tape processing 35, 86 
IBM 3480 tape volume high speed search 30 
identifying tape reels 119-120 
IEHINITT program 
assigning volume serial numbers 38—39 
creating ANSI standard labels 65,79 
creating IBM standard labels 27 
dummy ANSI HDR1 label 79, 83 
dummy IBM HDR1 label 27 
input data sets 
specifying 7 
with ANSI standard labels 69-78 
with IBM standard labels 19-26 
with no labels 105-109 
input/output support routines 7 
See a/so open routine, close routine, EOV routine 
installation exit, WTOR 56, 127 
International Organization for Standardization (ISO) 
See ANSI standard labels 
introduction to tape processing 1—12 
ISCIIl interchange tape 
See ASCII interchange tape 
ISCII/ASCI! control characters 50 
ISO (International Organization for Standardization) 
standard labels 
See ANS] standard labels 


J 
JFCB (job file control block) 
data set sequence number 
See positioning tapes 
header label information 20—23 
merging control block information 20-23 
updating the 3—4 
volume serial number 25, 28, 36—40 
job and job step name 
in ANSI data set label 99 
in IBM data set label 50 
job control statements 2—/ 
job file control block 
See JFCB 


L 


label identifier 
data set labels 
ANSI 91, 97 
IBM 42, 48, 52 
user labels 
ANSI 101 
IBM 52 
volume label 
ANSI! 87 
IBM 38 
label number 
data set labels 
ANSI 91, 97 
IBM 42, 48 


140 MVS/XA Magnetic Tape Labels and File Structure Administration 


























label number (continued) 
user labels 
ANSI 101 
IBM 52 
volume label 
ANSI 88 
IBM 38 
LABEL parameter 2 
label processing 
ANSI standard labels 68 
as used by other system components’ 117 
IBM standard labels 17—19 
label. standard level 
in ANSI standard volume label 89 
label type 2 
label (volume) editor routines 113 
labels, tape 
definition of 1-3 
external 119-120 
model 2 
types of 1-3 
LEAVE parameter 
explained 8 
for ANSI standard labels 71 
for IBM standard labels 20 
for no labels 107 
linkage editor 117 
load point 12 
LPALIB 
volume verification routines 104 


M 


magnetic tape characteristics 9-12 
magnetic tape labels 
See labels, tape 
merging control block data 4 
model data set label 2 
module names 
for nonstandard label routines 103 
for volume label editor routines 113 
mount switch (UCBDMCT) 
ANSI standard labels 70 
IBM standard labels 19, 29 
mounting volumes in advance 8 
multiple data sets 
DD statements for 6 
with ANSI standard labels 
end-of-volume conditions 85 
for input data sets 71-72 
for output data set 83 
volume organization 55-62 
with IBM standard labels 
end-of-volume conditions 34 
for input data sets 20-23 
for output data set 29-33 
restart procedure 35 
volume organization 13-15 
with no labels 106-108 


multiple data sets (continued) 
with nonstandard labels 103 
multiple volumes 
DD statements for 6 
with ANSI standard labels 
checking volume labels 70-78 
creating a volume label 80 
switching volumes 77, 84 
volume organization 55—62 
with IBM standard labels 
checking volume labels 19, 25—26 
creating a volume label 27 
from other systems 115 
switching volumes 24 
volume organization 13-15 
with no labels 108—109 
with nonstandard labels 103 
with RACF protection 6 


N 


named generation group 5 
new volume labels 
ANSI standard volume labels 85 
IBM standard volume labels 27 
nine-track tapes 9 
NL subparameter 105, 107 
nonstandard label processing routines 
with RACF 
See RACF nonstandard labels 
nonstandard label routines, module names 
nonstandard labels component support 
features 117 
in other systems 116 
specification of 1 
NRZI mode 10 
NSL subparameter 2 
NSLCTRLO member 103 
NSLEHDRI member 103 
NSLEHDRO member 103 
NSLETRLI member 103 
NSLETRLO member’ 103 
NSLOHDRI member 103 
NSLOHDRO member 103 
NSLREPOS routine 104 
NSLRHDRI member 103 


O 
OMODVOL1 113 
OPEN macro 
overriding INOUT and OUTIN parameters 
processing for a tape data set /7—9 
Open routine 
for ANSI standard labels 69—75, 81-84 
for IBM standard labels 19-23, 28-33 
fornolabels 105—111 
function of 7 


103 


3 
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opening an input data set | 
with ANSI standard labels 69-75 
with IBM standard labels 19-23 _ 
with no labels 105-108 
-Opening an output data set | 
ANSI standard labels, specified 81—84 
IBM standard labels specified 28—33 
no labels specified 109 | 
open/EOV user exit for nonspecific tape mount 
requests 28 7 
open/EOV user exit for security verification 22, 26, 
31, 33 
open, volume label editor routine 113 
output data set 
with ANSI standard labels 81—86 
with IBM standard labels 28—34 
with no labels 109-112 
owner identification 
in IBM standard volume label 39 
owner identifier 
in ANSI standard volume label 89 


p 


parity 9-12 
passed data sets, when to define attributes 6 
password protection 
See data set protection 
PE (phase encoded) mode 10 
phase encoded (PE) mode 10 
PL/L 117 
positioning tapes 
using OPEN and CLOSE parameters 8 
with ANSI standard labels 71-72, 82 
with IBM standard labels 20-21, 29-31 
with no labels 106—109, 111 
processing routines 7 
protection 
See data set protection 


R 
RACF 

ANSI standard labels 
accessibility 89, 94 
creating a volume label 79 
opening an input data set 69-75 
Opening an output data set 81-84 
processing on the new volume 64, 85 
protection with existing label 64 

how to protect tape volumes under 3 

IBM standard labels 
checking the next volume 25 
creating a volume label 27 
end of volume on output 34 
Opening an input data set 19-23 
opening an output data set 28—33 
password checking 22, 31—33_ 
processing on new volumes 34 
protection and data set name on existing 

label 31 


RACF (continued) 
IBM standard labels (continued) 
writing data set header labels 32 
multiple volumes protected by 6 
nonstandard labels © 
opening an output data set 109—110 
tape volumes defined to 1 
RACF 1.7 3, 26, 29 
RDBACK parameter 
explained 7 
restriction with data conversion 10 
with ANSI standard labels 70, 71, 75, 85, 86 
with IBM standard labels 20, 23, 25 
with no labels 108 
record format 
with ANSI standard labels 97 
with IBM standard labels 22, 48 
record length 
in ANSI standard data set label 2 98 
reel label 119 
reflective strip 
function of 12 
writing beyond 
ANSI standard labels 85 
IBM standard labels 34 
relative generation number 5 
REREAD parameter 8 
Resource Access Control Facility 
See RACF 
restart routine 
control block fields 124 
function of 8 
with IBM standard labels 35 
with no labels 112 
work areas 121-126 
retention period 
See expiration date 
reverse merge of DCB 4 
reverse read 
See RDBACK 
RPG (Report Program Generator) 117 


S 
scratch tape 
with ANSI standard labels 80, 84, 88 
with IBM standard labels 28, 38 
with no labels 110 
security protection 
See data set protection 
security status code 
in ANSI data set label 1 94 
in IBM data set label 1 44 
sense byte 12 
SL subparameter 13 
sort/merge program 117 
standard labels 
See ANSI or IBM standard labels 
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standard volume label 
See volume label 
SUL subparameter 13 
system code 
in ANSI standard data set label 1 95 
with IBM standard labels 46 
system generation 
for bypass label processing 110 
for 7-track density 10-12 
system input tapes (SYSIN) 11 
system output tapes (SYSOUT) 11, 29 


T 


tape characteristics 9-12 
tape disposition 8 
tape format 2 
tape labels 
See labels, tape 
tape recording technique 12, 50, 99 
tape reposition routine 103 
tape units 9, 12 
tapemarks 
defined 12 
how processed 12 
with ANSI standard labels 64 
with IBM standard labels 17 
with no labels 106—108, 110 
track density 9-12 
trailer labels 
ANSI standard 
deferred processing of 75 
definition of 64 
format of 89--100 
IBM standard 
deferred processing of 18 
definition of 1, 16 
format of 40, 46 
nonstandard 10-12 
translation 
ASCII to/from EBCDIC 56, 129 
BCD to/from EBCDIC 10 
TRTCH parameter 11 


U 
UCBDMCT 
See mount switch 
unit exception bit, when set 12 
unlabeled tapes 116 
component supports of 117 
processing of 105--112 
replaced by labeled tape 110 
specification of 1 
user identification 
See owner identification 
volume layouts for 107 
user labels 
ANSI standard 
format of 100—101 





user labels (continued) 

ANSI standard (continued) 
location on volume 55-62 
processing of 75, 76 
writing 84, 85 

IBM standard 
component support of 117 
deferred processing of 18 
format of 52-53 
location on volume 13-15 
processing requirements 16 

utility programs 117 
See a/so IEHINITT program 


V 


variable-length record 10—12 
verification of volume labels 113 
version number of generation 
in ANSI standard data set label 1 93 
version numbers 
explained 5 
with IBM standard labels 44 
Version 1 
See ANSI standard labels 
Version 3 
See ANSI standard labels 
volume disposition 8 
volume identifier 
in ANSI standard volume label 88 
volume label 
ANSI standard 
creation of 63, 79 
definition of 63 
format of 86-89 
processing of 69, 81 
IBM standard 
creation of 27 
definition of 16 
format of 36—39 
processing of 17, 19, 25—26, 28, 33 
volume label editor routines 113 
module names” 113 
volume label verification 113 
volume organization 
ANSI standard labels 59-62 
basic layouts 2 
IBM standard labels 13-15 
unlabeled tapes 105—108 
VOLUME parameter 6 
volume sequence number 
with ANSI standard labels 
volume switching 77 
with IBM standard labels 
location in header label 43 
volume switching 24 
volume serial number 
assigned in JCL statements 38—39 
assigned through IEHINITT 38—39 
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volume serial number (continued) 
assigning by system 111 
in external labels 119-120 
with ANSI standard labels - 
explained 88 a, 
input processing of 70° 
output processing of 82 — 
switching volumes 77 
with IBM standard labels _ 
explained 19 | 
input processing 19 | 
output processing 28 
switching volumes 24 
with no labels 108—110 
volume switching 
provisions in EOV routines 7 
with ANSI standard labels 77, 84 
with IBM standard labels 24-25, 33 
with no labels 108—109 
volumes created by other systems 115 
VOL1 label 
See volume label 


W 


work area 
for restart routines 121-126 
restart routines 126 

WTOR installation exit 56, 127 


Numerics 
18-track tapes 11 
3430 Magnetic Tape Subsystem 
tape characteristics 9 
3480 Magnetic Tape Subsystem 
and the open and EOV modules 28 
specifying density 11 
18-track feature 11 
3480 tape processing 35, 86 
3480 tape volume high speed search 30 
7-track feature 
density requirements 11 
lack of ANSI support for 10 
models allowing 10 
with code translation 10-12 
with data conversion feature 10 
7-track tapes 10-12 
9-track tapes 9 
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